Method

GtkIconViewget_tooltip_context

Declaration [src]

gboolean
gtk_icon_view_get_tooltip_context (
  GtkIconView* icon_view,
  int x,
  int 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.

Parameters

x int
 

The x coordinate (relative to widget coordinates)

y int
 

The y coordinate (relative to widget coordinates)

keyboard_tip gboolean
 

Whether this is a keyboard tooltip or not.

model GtkTreeModel
 

A pointer to receive a GtkTreeModel

 The argument will be set by the function.
 The argument can be NULL.
 The data is owned by the caller of the function.
path GtkTreePath
 

A pointer to receive a GtkTreePath

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

A pointer to receive a GtkTreeIter

 The argument will be set by the function.
 The argument can be NULL.
 The data is owned by the caller of the function.

Return value

Returns: gboolean
 

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