Method

GtkTreeViewget_path_at_pos

Declaration [src]

gboolean
gtk_tree_view_get_path_at_pos (
  GtkTreeView* tree_view,
  gint x,
  gint y,
  GtkTreePath** path,
  GtkTreeViewColumn** column,
  gint* cell_x,
  gint* cell_y
)

Description [src]

Finds the path at the point (x, y), relative to bin_window coordinates (please see gtk_tree_view_get_bin_window()). That is, x and y are relative to an events coordinates. x and y must come from an event on the tree_view only where event->window == gtk_tree_view_get_bin_window (). It is primarily for things like popup menus. If path is non-NULL, then it will be filled with the GtkTreePath at that point. This path should be freed with gtk_tree_path_free(). If column is non-NULL, then it will be filled with the column at that point. cell_x and cell_y return the coordinates relative to the cell background (i.e. the background_area passed to gtk_cell_renderer_render()). This function is only meaningful if tree_view is realized. Therefore this function will always return FALSE if tree_view is not realized or does not have a model.

For converting widget coordinates (eg. the ones you get from GtkWidget::query-tooltip), please see gtk_tree_view_convert_widget_to_bin_window_coords().

Parameters

x

Type: gint

The x position to be identified (relative to bin_window).

y

Type: gint

The y position to be identified (relative to bin_window).

path

Type: GtkTreePath

A pointer to a GtkTreePath pointer to be filled in, or NULL.

The argument will be set by the function.
The argument can be set to NULL by the method.
The argument can be NULL.
The caller of the method takes ownership of the returned data, and is responsible for freeing it.
column

Type: GtkTreeViewColumn

A pointer to a GtkTreeViewColumn pointer to be filled in, or NULL.

The argument will be set by the function.
The argument can be set to NULL by the method.
The argument can be NULL.
The returned data is owned by the instance.
cell_x

Type: gint*

A pointer where the X coordinate relative to the cell can be placed, or NULL.

The argument will be set by the function.
The argument can be NULL.
cell_y

Type: gint*

A pointer where the Y coordinate relative to the cell can be placed, or NULL.

The argument will be set by the function.
The argument can be NULL.

Return value

Type: gboolean

TRUE if a row exists at that coordinate.