2004-07-04 19:34:49 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkIconView
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
A widget which displays a list of icons in a grid
|
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2004-07-13 05:16:59 +00:00
|
|
|
#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 gtk_icon_view_set_selection_mode()).
|
|
|
|
In addition to selection with the arrow keys, #GtkIconView supports
|
|
|
|
rubberband selection, which is controlled by dragging the pointer.
|
2004-07-04 19:34:49 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkIconView ##### -->
|
|
|
|
<para>
|
2004-07-13 05:16:59 +00:00
|
|
|
The <structname>GtkIconView</structname> struct contains only
|
|
|
|
private fields and should not be directly accessed.
|
2004-07-04 19:34:49 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### SIGNAL GtkIconView::activate-cursor-item ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::item-activated ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::move-cursor ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
@arg2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::select-all ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::select-cursor-item ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::selection-changed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::set-scroll-adjustments ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
@arg2:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::toggle-cursor-item ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkIconView::unselect-all ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@iconview: the object which received the signal.
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
<!-- ##### ARG GtkIconView:column-spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:columns ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:item-width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:margin ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkIconView:markup-column ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:model ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:orientation ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:pixbuf-column ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
<!-- ##### ARG GtkIconView:row-spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkIconView:selection-mode ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
<!-- ##### ARG GtkIconView:spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkIconView:text-column ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:selection-box-alpha ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkIconView:selection-box-color ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### STRUCT GtkIconViewPrivate ##### -->
|
2004-07-07 16:22:57 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### USER_FUNCTION GtkIconViewForeachFunc ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
2004-07-18 15:14:05 +00:00
|
|
|
A function used by gtk_icon_view_selected_foreach() to map all
|
|
|
|
selected rows. It will be called on every selected row in the view.
|
2004-07-04 19:34:49 +00:00
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@path: The #GtkTreePath of a selected row
|
|
|
|
@data: user data
|
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@model: The #GtkTreeModel being viewed
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_new ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_new_with_model ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@model:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_model ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@model:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_model ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_text_column ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@column:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_text_column ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_markup_column ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@column:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_markup_column ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_pixbuf_column ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@column:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_pixbuf_column ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_path_at_pos ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_selected_foreach ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
2004-07-18 15:14:05 +00:00
|
|
|
|
2004-07-04 19:34:49 +00:00
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@func:
|
|
|
|
@data:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_selection_mode ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
|
|
|
@mode:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_selection_mode ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
@icon_view:
|
2004-07-04 19:34:49 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_orientation ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
2004-07-18 15:14:05 +00:00
|
|
|
@orientation:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_orientation ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_columns ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@columns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_columns ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_item_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@item_width:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_item_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@spacing:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_row_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@row_spacing:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_row_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_column_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@column_spacing:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_column_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_set_margin ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@margin:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_margin ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_select_path ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
2004-07-18 15:14:05 +00:00
|
|
|
@path:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_unselect_path ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
2004-07-18 15:14:05 +00:00
|
|
|
@path:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_path_is_selected ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
2004-07-18 15:14:05 +00:00
|
|
|
@path:
|
|
|
|
@Returns:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_get_selected_items ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_select_all ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_unselect_all ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
|
|
|
|
|
|
|
|
2004-07-18 15:14:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_view_item_activated ##### -->
|
2004-07-04 19:34:49 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_view:
|
2004-07-18 15:14:05 +00:00
|
|
|
@path:
|
2004-07-04 19:34:49 +00:00
|
|
|
|
|
|
|
|