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. Therefore this function will always return `FALSE` if `tree.view` is not realized or does not have a model.

### Usage

    gtkTreeViewGetPathAtPos(object, x, y)

### Arguments

``object`` | A `GtkTreeView`.
``x`` | The x position to be identified (relative to bin_window).
``y`` | 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`` | A pointer to a `GtkTreePath` pointer to be filled in, or `NULL`. [ out ][ allow-none ]
``column`` | A pointer to a `GtkTreeViewColumn` pointer to be filled in, or `NULL`. [ out ][ allow-none ]
``cell.x`` | A pointer where the X coordinate relative to the cell can be placed, or `NULL`. [ out ][ allow-none ]
``cell.y`` | A pointer where the Y coordinate relative to the cell can be placed, or `NULL`. [ out ][ allow-none ]

### Author(s)

Derived by RGtkGen from GTK+ documentation

[Package RGtk2 version 2.20.36.3 Index]