Method

GtkIconViewget_tooltip_context

since: 2.12

Declaration [src]

gboolean
gtk_icon_view_get_tooltip_context (
  GtkIconView* icon_view,
  gint* x,
  gint* y,
  gboolean keyboard_tip,
  GtkTreeModel** model,
  GtkTreePath** path,
  GtkTreeIter* iter
)

Description [src]

This function is supposed to be used in a GtkWidget::query-tooltip signal handler for GtkIconView. The x, y and keyboard_tip values which are received in the signal handler, should be passed to this function without modification.

The return value indicates whether there is an icon view item at the given coordinates (TRUE) or not (FALSE) for mouse tooltips. For keyboard tooltips the item returned will be the cursor item. When TRUE, then any of model, path and iter which have been provided will be set to point to that row and the corresponding model. x and y will always be converted to be relative to icon_view’s bin_window if keyboard_tooltip is FALSE.

Available since: 2.12

Parameters

x

Type: gint*

The x coordinate (relative to widget coordinates).

The argument will be modified by the function.
y

Type: gint*

The y coordinate (relative to widget coordinates).

The argument will be modified by the function.
keyboard_tip

Type: gboolean

Whether this is a keyboard tooltip or not.

model

Type: GtkTreeModel

A pointer to receive a GtkTreeModel or NULL.

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

Type: GtkTreePath

A pointer to receive a GtkTreePath or NULL.

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

Type: GtkTreeIter

A pointer to receive a GtkTreeIter or NULL.

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

Return value

Type: gboolean

Whether or not the given tooltip context points to a item.