GtkIconView

Description

A widget which displays a list of icons in a grid

Methods and Functions

gtkIconViewNew(show = TRUE)
gtkIconViewNewWithModel(model = NULL, show = TRUE)
gtkIconViewSetModel(object, model = NULL)
gtkIconViewGetModel(object)
gtkIconViewSetTextColumn(object, column)
gtkIconViewGetTextColumn(object)
gtkIconViewSetMarkupColumn(object, column)
gtkIconViewGetMarkupColumn(object)
gtkIconViewSetPixbufColumn(object, column)
gtkIconViewGetPixbufColumn(object)
gtkIconViewGetPathAtPos(object, x, y)
gtkIconViewGetItemAtPos(object, x, y)
gtkIconViewSetCursor(object, path, cell, start.editing)
gtkIconViewGetCursor(object)
gtkIconViewSelectedForeach(object, func, data = NULL)
gtkIconViewSetSelectionMode(object, mode)
gtkIconViewGetSelectionMode(object)
gtkIconViewSetOrientation(object, orientation)
gtkIconViewGetOrientation(object)
gtkIconViewSetColumns(object, columns)
gtkIconViewGetColumns(object)
gtkIconViewSetItemWidth(object, item.width)
gtkIconViewGetItemWidth(object)
gtkIconViewSetSpacing(object, spacing)
gtkIconViewGetSpacing(object)
gtkIconViewSetRowSpacing(object, row.spacing)
gtkIconViewGetRowSpacing(object)
gtkIconViewSetColumnSpacing(object, column.spacing)
gtkIconViewGetColumnSpacing(object)
gtkIconViewSetMargin(object, margin)
gtkIconViewGetMargin(object)
gtkIconViewSelectPath(object, path)
gtkIconViewUnselectPath(object, path)
gtkIconViewPathIsSelected(object, path)
gtkIconViewGetSelectedItems(object)
gtkIconViewSelectAll(object)
gtkIconViewUnselectAll(object)
gtkIconViewItemActivated(object, path)
gtkIconViewScrollToPath(object, path, use.align, row.align, col.align)
gtkIconViewGetVisibleRange(object)
gtkIconViewEnableModelDragSource(object, start.button.mask, targets, actions)
gtkIconViewEnableModelDragDest(object, targets, actions)
gtkIconViewUnsetModelDragSource(object)
gtkIconViewUnsetModelDragDest(object)
gtkIconViewSetReorderable(object, reorderable)
gtkIconViewGetReorderable(object)
gtkIconViewSetDragDestItem(object, path, pos)
gtkIconViewGetDragDestItem(object)
gtkIconViewGetDestItemAtPos(object, drag.x, drag.y)
gtkIconViewCreateDragIcon(object, path)
gtkIconView(model = NULL, show = TRUE)

Hierarchy

  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkIconView

Interfaces

GtkIconView implements AtkImplementorIface and GtkCellLayout.

Detailed Description

GtkIconView provides an alternative view on a list model. It displays the model as a grid of icons with labels. Like GtkTreeView, it allows to select one or multiple items (depending on the selection mode, see gtkIconViewSetSelectionMode). In addition to selection with the arrow keys, GtkIconView supports rubberband selection, which is controlled by dragging the pointer.

Structures

GtkIconView

The GtkIconView struct contains only private fields and should not be directly accessed.

Convenient Construction

gtkIconView is the result of collapsing the constructors of GtkIconView (gtkIconViewNew, gtkIconViewNewWithModel) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.

Enums and Flags

GtkIconViewDropPosition

no-drop

undocumented

drop-into

undocumented

drop-left

undocumented

drop-right

undocumented

drop-above

undocumented

drop-below

undocumented

User Functions

GtkIconViewForeachFunc(icon.view, path, data)

A function used by gtkIconViewSelectedForeach to map all selected rows. It will be called on every selected row in the view.

icon.view

[GtkIconView]

path

[GtkTreePath] The GtkTreePath of a selected row

data

[R object] user data

Signals

activate-cursor-item(iconview, user.data)

iconview

[GtkIconView] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

item-activated(iconview, arg1, user.data)

iconview

[GtkIconView] the object which received the signal.

arg1

[GtkTreePath]

user.data

[R object] user data set when the signal handler was connected.

move-cursor(iconview, arg1, arg2, user.data)

iconview

[GtkIconView] the object which received the signal.

arg1

[GtkMovementStep]

arg2

[integer]

user.data

[R object] user data set when the signal handler was connected.

select-all(iconview, user.data)

iconview

[GtkIconView] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

select-cursor-item(iconview, user.data)

iconview

[GtkIconView] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

selection-changed(iconview, user.data)

iconview

[GtkIconView] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

set-scroll-adjustments(iconview, arg1, arg2, user.data)

iconview

[GtkIconView] the object which received the signal.

arg1

[GtkAdjustment]

arg2

[GtkAdjustment]

user.data

[R object] user data set when the signal handler was connected.

toggle-cursor-item(iconview, user.data)

iconview

[GtkIconView] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

unselect-all(iconview, user.data)

iconview

[GtkIconView] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

Properties

column-spacing [integer : Read / Write]

Space which is inserted between grid column. Allowed values: >= 0 Default value: 6

columns [integer : Read / Write]

The columns property contains the number of the columns in which the items should be displayed. If it is -1, the number of columns will be chosen automatically to fill the available area.

Allowed values: >= -1 Default value: -1 Since 2.6

item-width [integer : Read / Write]

The width used for each item. Allowed values: >= -1 Default value: -1

margin [integer : Read / Write]

Space which is inserted at the edges of the icon view. Allowed values: >= 0 Default value: 6

markup-column [integer : Read / Write]

The ::markup-column property contains the number of the model column containing markup information to be displayed. The markup column must be of type G_TYPE_STRING. If this property and the :text-column property are both set to column numbers, it overrides the text column. If both are set to -1, no texts are displayed.

Allowed values: >= -1 Default value: -1 Since 2.6

model [GtkTreeModel : Read / Write]

The model for the icon view.

orientation [GtkOrientation : Read / Write]

How the text and icon of each item are positioned relative to each other. Default value: GTK_ORIENTATION_VERTICAL

pixbuf-column [integer : Read / Write]

The ::pixbuf-column property contains the number of the model column containing the pixbufs which are displayed. The pixbuf column must be of type GDK_TYPE_PIXBUF. Setting this property to -1 turns off the display of pixbufs.

Allowed values: >= -1 Default value: -1 Since 2.6

reorderable [logical : Read / Write]

The reorderable property specifies if the items can be reordered by drag-and-drop.

Default value: FALSE Since 2.8

row-spacing [integer : Read / Write]

Space which is inserted between grid rows. Allowed values: >= 0 Default value: 6

selection-mode [GtkSelectionMode : Read / Write]

The ::selection-mode property specifies the selection mode of icon view. If the mode is GTK_SELECTION_MULTIPLE, rubberband selection is enabled, for the other modes, only keyboard selection is possible.

Default value: GTK_SELECTION_SINGLE Since 2.6

spacing [integer : Read / Write]

Space which is inserted between cells of an item. Allowed values: >= 0 Default value: 0

text-column [integer : Read / Write]

The ::text-column property contains the number of the model column containing the texts which are displayed. The text column must be of type G_TYPE_STRING. If this property and the :markup-column property are both set to -1, no texts are displayed.

Allowed values: >= -1 Default value: -1 Since 2.6

Style Properties

selection-box-alpha [raw : Read]

Opacity of the selection box. Default value: 64

selection-box-color [GdkColor : Read]

Color of the selection box.

Author(s)

Derived by RGtkGen from GTK+ documentation

References

http://developer.gnome.org/doc/API/2.0/gtk/GtkIconView.html