2
2
@c %start of fragment
4
4
@deftp Class <gtk-icon-view>
5
This @code{<gobject>} class defines the following properties:
5
Derives from @code{<gtk-cell-layout>}, @code{<gtk-container>}.
7
This class defines the following slots:
9
Model column used to retrieve the icon pixbuf from@item text-column
10
Model column used to retrieve the text from@item markup-column
11
Model column used to retrieve the text if using Pango markup@item selection-mode
12
The selection mode@item orientation
13
How the text and icon of each item are positioned relative to each other@item model
14
The model for the icon view@item columns
15
Number of columns to display@item item-width
16
The width used for each item@item spacing
17
Space which is inserted between cells of an item@item row-spacing
18
Space which is inserted between grid rows@item column-spacing
19
Space which is inserted between grid columns@item margin
20
Space which is inserted at the edges of the icon view@item reorderable
21
View is reorderable@item tooltip-column
22
The column in the model containing the tooltip texts for the items@end table
11
Model column used to retrieve the icon pixbuf from
14
Model column used to retrieve the text from
17
Model column used to retrieve the text if using Pango markup
23
How the text and icon of each item are positioned relative to each other
26
The model for the icon view
29
Number of columns to display
32
The width used for each item
35
Space which is inserted between cells of an item
38
Space which is inserted between grid rows
41
Space which is inserted between grid columns
44
Space which is inserted at the edges of the icon view
50
The column in the model containing the tooltip texts for the items
252
@deffn Function gtk-icon-view-get-item-at-pos (self@tie{}@code{<gtk-icon-view>}) (x@tie{}@code{int}) (y@tie{}@code{int}) (path@tie{}@code{<gtk-tree-path**>}) (cell@tie{}@code{<gtk-cell-renderer**>}) @result{}@tie{} (ret@tie{}@code{bool})
253
@deffnx Method get-item-at-pos
254
Finds the path at the point (@var{x}, @var{y}), relative to widget coordinates.
255
In contrast to @code{gtk-icon-view-get-path-at-pos}, this function also obtains
256
the cell at the specified position. The returned path should be freed with
257
@code{gtk-tree-path-free}.
261
A @code{<gtk-icon-view>}.
264
The x position to be identified
267
The y position to be identified
270
Return location for the path, or @samp{@code{#f}}
273
Return location for the renderer responsible for the cell at (@var{x}, @var{y}),
277
@samp{@code{#t}} if an item exists at the specified position
285
282
@deffn Function gtk-icon-view-set-cursor (self@tie{}@code{<gtk-icon-view>}) (path@tie{}@code{<gtk-tree-path>}) (cell@tie{}@code{<gtk-cell-renderer>}) (start_editing@tie{}@code{bool})
286
283
@deffnx Method set-cursor
287
284
Sets the current keyboard focus to be at @var{path}, and selects it. This is
316
@deffn Function gtk-icon-view-get-cursor (self@tie{}@code{<gtk-icon-view>}) (path@tie{}@code{<gtk-tree-path**>}) (cell@tie{}@code{<gtk-cell-renderer**>}) @result{}@tie{} (ret@tie{}@code{bool})
317
@deffnx Method get-cursor
318
Fills in @var{path} and @var{cell} with the current cursor path and cell. If the
319
cursor isn't currently set, then *@var{path} will be @samp{@code{#f}}. If no
320
cell currently has focus, then *@var{cell} will be @samp{@code{#f}}.
322
The returned @code{<gtk-tree-path>} must be freed with
323
@code{gtk-tree-path-free}.
327
A @code{<gtk-icon-view>}
330
Return location for the current cursor path, or @samp{@code{#f}}
333
Return location the current focus cell, or @samp{@code{#f}}
336
@samp{@code{#t}} if the cursor is set.
344
313
@deffn Function gtk-icon-view-set-selection-mode (self@tie{}@code{<gtk-icon-view>}) (mode@tie{}@code{<gtk-selection-mode>})
345
314
@deffnx Method set-selection-mode
346
315
Sets the selection mode of the @var{icon-view}.
796
@deffn Function gtk-icon-view-get-visible-range (self@tie{}@code{<gtk-icon-view>}) (start_path@tie{}@code{<gtk-tree-path**>}) (end_path@tie{}@code{<gtk-tree-path**>}) @result{}@tie{} (ret@tie{}@code{bool})
797
@deffnx Method get-visible-range
798
Sets @var{start-path} and @var{end-path} to be the first and last visible path.
799
Note that there may be invisible paths in between.
801
Both paths should be freed with @code{gtk-tree-path-free} after use.
805
A @code{<gtk-icon-view>}
808
Return location for start of region, or @samp{@code{#f}}
811
Return location for end of region, or @samp{@code{#f}}
814
@samp{@code{#t}}, if valid paths were placed in @var{start-path} and
823
765
@deffn Function gtk-icon-view-unset-model-drag-dest (self@tie{}@code{<gtk-icon-view>})
824
766
@deffnx Method unset-model-drag-dest
825
767
Undoes the effect of @code{gtk-icon-view-enable-model-drag-dest}.
902
@deffn Function gtk-icon-view-get-drag-dest-item (self@tie{}@code{<gtk-icon-view>}) (path@tie{}@code{<gtk-tree-path**>}) (pos@tie{}@code{<gtk-icon-view-drop-position*>})
903
@deffnx Method get-drag-dest-item
904
Gets information about the item that is highlighted for feedback.
908
a @code{<gtk-icon-view>}
911
Return location for the path of the highlighted item, or @samp{@code{#f}}.
914
Return location for the drop position, or @samp{@code{#f}}
922
@deffn Function gtk-icon-view-get-dest-item-at-pos (self@tie{}@code{<gtk-icon-view>}) (drag_x@tie{}@code{int}) (drag_y@tie{}@code{int}) (path@tie{}@code{<gtk-tree-path**>}) (pos@tie{}@code{<gtk-icon-view-drop-position*>}) @result{}@tie{} (ret@tie{}@code{bool})
923
@deffnx Method get-dest-item-at-pos
924
Determines the destination item for a given position.
928
a @code{<gtk-icon-view>}
931
the position to determine the destination item for
934
the position to determine the destination item for
937
Return location for the path of the item, or @samp{@code{#f}}.
940
Return location for the drop position, or @samp{@code{#f}}
943
whether there is an item at the given position.
951
@deffn Function gtk-icon-view-create-drag-icon (self@tie{}@code{<gtk-icon-view>}) (path@tie{}@code{<gtk-tree-path>}) @result{}@tie{} (ret@tie{}@code{<gdk-pixmap*>})
844
@deffn Function gtk-icon-view-create-drag-icon (self@tie{}@code{<gtk-icon-view>}) (path@tie{}@code{<gtk-tree-path>}) @result{}@tie{} (ret@tie{}@code{<gdk-pixmap>})
952
845
@deffnx Method create-drag-icon
953
846
Creates a @code{<gdk-pixmap>} representation of the item at @var{path}. This
954
847
image is used for a drag icon.