scroll_to_cell


Description:

public void scroll_to_cell (TreePath? path, TreeViewColumn? column, bool use_align, float row_align, float col_align)

Moves the alignments of this to the position specified by column and path.

If column is null, then no horizontal scrolling occurs. Likewise, if path is null no vertical scrolling occurs. At a minimum, one of column or path need to be non-null. row_align determines where the row is placed, and col_align determines where column is placed. Both are expected to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means center.

If use_align is false, then the alignment arguments are ignored, and the tree does the minimum amount of work to scroll the cell onto the screen. This means that the cell will be scrolled to the edge closest to its current position. If the cell 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 this is realized, the centered path will be modified to reflect this change.

Parameters:

this

A TreeView.

path

The path of the row to move to, or null.

column

The TreeViewColumn to move horizontally to, or null.

use_align

whether to use alignment arguments, or false.

row_align

The vertical alignment of the row specified by path.

col_align

The horizontal alignment of the column specified by column.