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
orNULL
.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
orNULL
.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
orNULL
.The argument will be set by the function. The argument can be NULL
.The returned data is owned by the instance.