GtkIconView {RGtk2}R Documentation

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)
gtkIconViewConvertWidgetToBinWindowCoords(object, wx, wy)
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)
gtkIconViewSetTooltipItem(object, tooltip, path)
gtkIconViewSetTooltipCell(object, tooltip, path, cell)
gtkIconViewGetTooltipContext(object, x, y, keyboard.tip)
gtkIconViewSetTooltipColumn(object, column)
gtkIconViewGetTooltipColumn(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
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkIconView

Interfaces

GtkIconView implements GtkBuildable, 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
An enum for determining where a dropped item goes.

no-drop
no drop possible
drop-into
dropped item replaces the item
drop-left
droppped item is inserted to the left
drop-right
dropped item is inserted to the right
drop-above
dropped item is inserted above
drop-below
dropped item is inserted below

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] a GtkIconView
path
[GtkTreePath] The GtkTreePath of a selected row
data
[R object] user data

Signals

The (iconview, user.data)
undocumented

iconview
[GtkIconView] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

The (iconview, arg1, user.data)
undocumented

iconview
[GtkIconView] the object which received the signal.
arg1
[GtkTreePath]
user.data
[R object] user data set when the signal handler was connected.

The (iconview, arg1, arg2, user.data)
undocumented

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.

The (iconview, user.data)
undocumented

iconview
[GtkIconView] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

The (iconview, user.data)
undocumented

iconview
[GtkIconView] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

The (iconview, user.data)
undocumented

iconview
[GtkIconView] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

The (iconview, arg1, arg2, user.data)
undocumented

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.

The (iconview, user.data)
undocumented

iconview
[GtkIconView] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

The (iconview, user.data)
undocumented

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]

The column-spacing property specifies the space which is inserted between the columns of the icon view.

Allowed values: >= 0 Default value: 6 Since 2.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 item-width property specifies the width to use for each item. If it is set to -1, the icon view will automatically determine a suitable item size.

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

margin [integer : Read / Write]

The margin property specifies the space which is inserted at the edges of the icon view.

Allowed values: >= 0 Default value: 6 Since 2.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]

The orientation property specifies how the cells (i.e. the icon and the text) of the item are positioned relative to each other.

Default value: GTK_ORIENTATION_VERTICAL Since 2.6

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 DND.

Default value: FALSE Since 2.8

row-spacing [integer : Read / Write]

The row-spacing property specifies the space which is inserted between the rows of the icon view.

Allowed values: >= 0 Default value: 6 Since 2.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]

The spacing property specifies the space which is inserted between the cells (i.e. the icon and the text) of an item.

Allowed values: >= 0 Default value: 0 Since 2.6

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

tooltip-column [integer : Read / Write]

The column in the model containing the tooltip texts for the items. Allowed values: >= -1 Default value: -1

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


[Package RGtk2 version 2.12.5-3 Index]