Package: gtk

Class gtk-icon-view

Superclasses

gtk-container, gtk-widget, g-initially-unowned, gtk-buildable, gtk-cell-layout, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

cell-area
The "cell-area" property of type gtk-cell-area (Read / Write / Construct)
The gtk-cell-area used to layout cell renderers for this view. If no area is specified when creating the icon view with gtk-icon-view-new-with-area a gtk-cell-area-box will be used.
Since 3.0
column-spacing
The "column-spacing" property of type :int (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
The "columns" property of type :int (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: >= G_MAXULONG
Default value: -1
Since 2.6
item-orientation
The "item-orientation" property of type gtk-orientation (Read / Write)
The "item-orientation" property specifies how the cells (i. e. the icon and the text) of the item are positioned relative to each other.
Default value: :vertical
Since 2.6
item-padding
The "item-padding" property of type :int (Read / Write)
The "item-padding" property specifies the padding around each of the icon view's item.
Allowed values: >= 0
Default value: 6
Since 2.18
item-width
The "item-width" property of type :int (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: >= G_MAXULONG
Default value: -1
Since 2.6
margin
The "margin" property of type :int (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
The "markup-column" property of type :int (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: >= G_MAXULONG
Default value: -1
Since 2.6
model
The "model" property of type gtk-tree-model (Read / Write)
The model for the icon view.
pixbuf-column
The "pixbuf-column" property of type :int (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: >= G_MAXULONG
Default value: -1
Since 2.6
reorderable
The "reorderable" property of type :boolean (Read / Write)
The reorderable property specifies if the items can be reordered by DND.
Default value: nil
Since 2.8
row-spacing
The "row-spacing" property of type :int (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
The "selection-mode" property of type gtk-selection-mode (Read / Write)
The "selection-mode" property specifies the selection mode of an icon view. If the mode is :multiple, rubberband selection is enabled, for the other modes, only keyboard selection is possible.
Default value: :single
Since 2.6
spacing
The "spacing" property of type :int (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
The "text-column" property of type :int (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: >= G_MAXULONG
Default value: -1
Since 2.6
tooltip-column
The "tooltip-column" property of type :int (Read / Write)
The column in the model containing the tooltip texts for the items.
Allowed values: >= G_MAXULONG
Default value: -1

Details

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

Note that if the tree model is backed by an actual tree store (as opposed to a flat list where the mapping to icons is obvious), gtk-icon-view will only display the first level of the tree and ignore the tree's branches.

Style Property Details

The "selection-box-alpha" style property
"selection-box-alpha" of type :uchar (Read)
Opacity of the selection box.
Default value: 64

The "selection-box-color" style property
"selection-box-color" of type gdk-color (Read)
Color of the selection box.

Signal Details

The "activate-cursor-item" signal
 lambda (iconview)   : Action      
A keybinding signal which gets emitted when the user activates the currently focused item. Applications should not connect to it, but may emit it with the function g-signal-emit-by-name if they need to control activation programmatically. The default bindings for this signal are Space, Return and Enter.
iconview
The object on which the signal is emitted.
The "item-activated" signal
 lambda (iconview path)   : Run Last      
The "item-activated" signal is emitted when the method gtk-icon-view-item-activated is called or the user double clicks an item. It is also emitted when a non-editable item is selected and one of the keys: Space, Return or Enter is pressed.
iconview
The object on which the signal is emitted.
path
The gtk-tree-path for the activated item.
The "move-cursor" signal
 lambda (iconview step count)   : Action      
The "move-cursor" signal is a keybinding signal which gets emitted when the user initiates a cursor movement. Applications should not connect to it, but may emit it with the function g-signal-emit-by-name if they need to control the cursor programmatically. The default bindings for this signal include
  • Arrow keys which move by individual steps.
  • Home/End keys which move to the first/last item.
  • PageUp/PageDown which move by "pages".
All of these will extend the selection when combined with the Shift modifier.
iconview
The object which received the signal.
step
The granularity of the move, as a gtk-movement-step.
count
The number of step units to move.
The "select-all" signal
 lambda (iconview)   : Action      
A keybinding signal which gets emitted when the user selects all items. Applications should not connect to it, but may emit it with the function g-signal-emit-by-name if they need to control selection programmatically. The default binding for this signal is Ctrl-a.
iconview
The object on which the signal is emitted.
The "select-cursor-item" signal
 lambda (iconview)   : Action      
A keybinding signal which gets emitted when the user selects the item that is currently focused. Applications should not connect to it, but may emit it with the function g-signal-emit-by-name if they need to control selection programmatically. There is no default binding for this signal.
iconview
The object on which the signal is emitted.
The "selection-changed" signal
 lambda (iconview)   : Run First      
The "selection-changed" signal is emitted when the selection (i. e. the set of selected items) changes.
iconview
The object on which the signal is emitted.
The "toggle-cursor-item" signal
 lambda (iconview)   : Action      
A keybinding signal which gets emitted when the user toggles whether the currently focused item is selected or not. The exact effect of this depend on the selection mode. Applications should not connect to it, but may emit it with the function g-signal-emit-by-name if they need to control selection programmatically. There is no default binding for this signal is Ctrl-Space.
iconview
The object on which the signal is emitted.
The "unselect-all" signal
 lambda (iconview)   : Action      
A keybinding signal which gets emitted when the user unselects all items. Applications should not connect to it, but may emit it with the function g-signal-emit-by-name if they need to control selection programmatically. The default binding for this signal is Ctrl-Shift-a.
iconview
The object on which the signal is emitted.
 

Slot Access Functions

Inherited Slot Access Functions

2013-6-19