Method

GtkIconViewscroll_to_path

since: 2.8

Declaration [src]

void
gtk_icon_view_scroll_to_path (
  GtkIconView* icon_view,
  GtkTreePath* path,
  gboolean use_align,
  gfloat row_align,
  gfloat col_align
)

Description [src]

Moves the alignments of icon_view to the position specified by path. 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 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 icon_view is realized, the centered path will be modified to reflect this change.

Available since: 2.8

Parameters

path

Type: GtkTreePath

The path of the item to move to.

The data is owned by the caller of the method.

use_align

Type: gboolean

Whether to use alignment arguments, or FALSE.

row_align

Type: gfloat

The vertical alignment of the item specified by path.

col_align

Type: gfloat

The horizontal alignment of the item specified by path.