gtkTreeViewGetPathAtPos {RGtk2}R Documentation

gtkTreeViewGetPathAtPos

Description

Finds the path at the point (x, y), relative to bin_window coordinates (please see gtkTreeViewGetBinWindow). 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. 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 gtkCellRendererRender). This function is only meaningful if tree.view is realized.

Usage

gtkTreeViewGetPathAtPos(object, x, y)

Arguments

object [GtkTreeView] A GtkTreeView.
x [integer] The x position to be identified (relative to bin_window).
y [integer] The y position to be identified (relative to bin_window).

Details

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

Value

A list containing the following elements:

retval [logical] TRUE if a row exists at that coordinate.
path [GtkTreePath] A pointer to a GtkTreePath pointer to be filled in, or NULL
column [GtkTreeViewColumn] A pointer to a GtkTreeViewColumn pointer to be filled in, or NULL
cell.x [integer] A pointer where the X coordinate relative to the cell can be placed, or NULL
cell.y [integer] A pointer where the Y coordinate relative to the cell can be placed, or NULL

Author(s)

Derived by RGtkGen from GTK+ documentation


[Package RGtk2 version 2.12.5-3 Index]