Package: gtk

Function gtk:icon-view-scroll-to-path

Lambda List

gtk:icon-view-scroll-to-path (view path &key rowalign colalign)

Arguments

view -- a gtk:icon-view widget
path -- a gtk:tree-path instance of the item to move to
rowalign -- a float with the vertical alignment of the item specified by path
colalign -- a float with the horizontal alignment of the item specified by path

Details

Moves the alignments of view to the position specified by path. The rowalign argument determines where the row is placed, and the colalign argument determines where the column is placed. Both are expected to be between 0.0 and 1.0. The 0.0 value means left/top alignment, the 1.0 value means right/bottom alignment, the 0.5 value means center. The keyword arguments have the 0.5 default value.

If both rowalign and colalign arguments are nil, then the alignment arguments are ignored, and the tree does the minimum amount of work to scroll the item onto the screen. This means that the item will be scrolled to the edge closest to its current position. If the item is currently visible on the screen, nothing is done.

This function only works if the model is set, and path is a valid row on the model. If the model changes before the view is realized, the centered path will be modified to reflect this change.
 

See also

#2024-3-24