Package: gtk

Function gtk-tree-view-is-blank-at-pos

Lambda List

gtk-tree-view-is-blank-at-pos (view x y)

Arguments

view -- a gtk-tree-view widget
x -- an integer with the x position to be identified (relative to the bin window)
y -- an integer with the y position to be identified (relative to the bin window)

Return Value

path -- a gtk-tree-path instance, or nil
column -- a gtk-tree-view-column object, or nil
cell-x -- an integer with the x coordinate relative to the cell, or nil
cell-y -- an integer where the y coordinate relative to the cell, or nil

Details

Determine whether the point (x, y) in the tree view is blank, that is no cell content nor an expander arrow is drawn at the location. If so, the location can be considered as the background. You might wish to take special action on clicks on the background, such as clearing a current selection, having a custom context menu or starting rubber banding.

The x and y coordinates that are provided must be relative to the bin window coordinates. That is, x and y must come from an event on the tree view where the window from the function gdk-event-window is equal to the window from the function gtk-tree-view-bin-window.

For converting widget coordinates, e.g. the ones you get from the "query-tooltip" signal, please see the function gtk-tree-view-convert-widget-to-bin-window-coords.

The path, column, cell-x and cell-y arguments will be returned likewise as for the function gtk-tree-view-path-at-pos.
 

See also

2021-2-26