Method

GtkTreeViewis_blank_at_pos

since: 3.0

Declaration [src] 

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

Description [src]

Determine whether the point (x, y) in tree_view is blank, that is no cell content nor an expander arrow is drawn at the location. If so, the location can be considered as the background. You might wish to take special action on clicks on the background, such as clearing a current selection, having a custom context menu or starting rubber banding.

The x and y coordinate that are provided must be relative to bin_window coordinates. That is, x and y must come from an event on tree_view where event->window == gtk_tree_view_get_bin_window ().

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

The path, column, cell_x and cell_y arguments will be filled in likewise as for gtk_tree_view_get_path_at_pos(). Please see gtk_tree_view_get_path_at_pos() for more information.

Available since: 3.0

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 the area at the given coordinates is blank, FALSE otherwise.