Package: gtk

Function gtk:tree-view-set-cursor

Lambda List

gtk:tree-view-set-cursor (view path &key focus start)

Arguments

view -- a gtk:tree-view widget
path -- a gtk:tree-path instance
focus -- a gtk:tree-view-column object, or nil
start -- true if the specified cell should start being edited

Details

Sets the current keyboard focus to be at path, and selects it. This is useful when you want to focus the user's attention on a particular row. If the focus argument is not nil, then focus is given to the column specified by it. Additionally, if the focus argument is specified, and the start argument is true, then editing should be started in the specified cell. This function is often followed by the gtk:widget-grab-focus function in order to give keyboard focus to the widget. Please note that editing can only happen when the tree view is realized.

If the path argument is invalid for the model, the current cursor (if any) will be unset and the function will return without failing.
 

See also

#2024-3-10