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 GDK window)
y -- an integer with the y position to be identified (relative to the GDK window)

Return Value

path -- a gtk:tree-path instance, or nil
column -- a gtk:tree-view-column object, or nil
xcell -- an integer with the x coordinate relative to the cell, or nil
ycell -- 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 GDK window coordinates. That is, x and y must come from an event on the tree view where the window from the gdk:event-window function is equal to the window from the gtk:tree-view-bin-window function.

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

The path, column, xcell and ycell values will be returned likewise as for the gtk:tree-view-path-at-pos function.
 

See also

#2024-3-12