gtkiconview

			gtk+ reference manual
top \| description \| object hierarchy \| implemented interfaces \| properties \| style properties \| signals

gtkiconview — виджет который отображает список значков в сетке

краткое описание

#include <gtk/gtk.h>


            gtkiconview;
void        (*gtkiconviewforeachfunc)       (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gpointer data);

gtkwidget*  gtk_icon_view_new               (void);
gtkwidget*  gtk_icon_view_new_with_model    (gtktreemodel *model);
void        gtk_icon_view_set_model         (gtkiconview *icon_view,
                                             gtktreemodel *model);

gtktreemodel* gtk_icon_view_get_model       (gtkiconview *icon_view);
void        gtk_icon_view_set_text_column   (gtkiconview *icon_view,
                                             gint column);

gint        gtk_icon_view_get_text_column   (gtkiconview *icon_view);
void        gtk_icon_view_set_markup_column (gtkiconview *icon_view,
                                             gint column);

gint        gtk_icon_view_get_markup_column (gtkiconview *icon_view);
void        gtk_icon_view_set_pixbuf_column (gtkiconview *icon_view,
                                             gint column);

gint        gtk_icon_view_get_pixbuf_column (gtkiconview *icon_view);
gtktreepath* gtk_icon_view_get_path_at_pos  (gtkiconview *icon_view,
                                             gint x,
                                             gint y);

gboolean    gtk_icon_view_get_item_at_pos   (gtkiconview *icon_view,
                                             gint x,
                                             gint y,
                                             gtktreepath **path,
                                             gtkcellrenderer **cell);
void        gtk_icon_view_set_cursor        (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gtkcellrenderer *cell,
                                             gboolean start_editing);

gboolean    gtk_icon_view_get_cursor        (gtkiconview *icon_view,
                                             gtktreepath **path,
                                             gtkcellrenderer **cell);
void        gtk_icon_view_selected_foreach  (gtkiconview *icon_view,
                                             gtkiconviewforeachfunc func,
                                             gpointer data);
void        gtk_icon_view_set_selection_mode

                                            (gtkiconview *icon_view,
                                             gtkselectionmode mode);
gtkselectionmode gtk_icon_view_get_selection_mode
                                            (gtkiconview *icon_view);
void        gtk_icon_view_set_orientation   (gtkiconview *icon_view,
                                             gtkorientation orientation);

gtkorientation gtk_icon_view_get_orientation
                                            (gtkiconview *icon_view);
void        gtk_icon_view_set_columns       (gtkiconview *icon_view,
                                             gint columns);

gint        gtk_icon_view_get_columns       (gtkiconview *icon_view);
void        gtk_icon_view_set_item_width    (gtkiconview *icon_view,
                                             gint item_width);

gint        gtk_icon_view_get_item_width    (gtkiconview *icon_view);
void        gtk_icon_view_set_spacing       (gtkiconview *icon_view,
                                             gint spacing);

gint        gtk_icon_view_get_spacing       (gtkiconview *icon_view);
void        gtk_icon_view_set_row_spacing   (gtkiconview *icon_view,
                                             gint row_spacing);

gint        gtk_icon_view_get_row_spacing   (gtkiconview *icon_view);
void        gtk_icon_view_set_column_spacing
                                            (gtkiconview *icon_view,
                                             gint column_spacing);

gint        gtk_icon_view_get_column_spacing
                                            (gtkiconview *icon_view);
void        gtk_icon_view_set_margin        (gtkiconview *icon_view,
                                             gint margin);

gint        gtk_icon_view_get_margin        (gtkiconview *icon_view);
void        gtk_icon_view_select_path       (gtkiconview *icon_view,
                                             gtktreepath *path);
void        gtk_icon_view_unselect_path     (gtkiconview *icon_view,
                                             gtktreepath *path);

gboolean    gtk_icon_view_path_is_selected  (gtkiconview *icon_view,
                                             gtktreepath *path);
glist*      gtk_icon_view_get_selected_items
                                            (gtkiconview *icon_view);
void        gtk_icon_view_select_all        (gtkiconview *icon_view);
void        gtk_icon_view_unselect_all      (gtkiconview *icon_view);
void        gtk_icon_view_item_activated    (gtkiconview *icon_view,
                                             gtktreepath *path);
void        gtk_icon_view_scroll_to_path    (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);

gboolean    gtk_icon_view_get_visible_range (gtkiconview *icon_view,
                                             gtktreepath **start_path,
                                             gtktreepath **end_path);

enum        gtkiconviewdropposition;
void        gtk_icon_view_enable_model_drag_source

                                            (gtkiconview *icon_view,
                                             gdkmodifiertype start_button_mask,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);
void        gtk_icon_view_enable_model_drag_dest

                                            (gtkiconview *icon_view,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);
void        gtk_icon_view_unset_model_drag_source
                                            (gtkiconview *icon_view);
void        gtk_icon_view_unset_model_drag_dest

                                            (gtkiconview *icon_view);
void        gtk_icon_view_set_reorderable   (gtkiconview *icon_view,
                                             gboolean reorderable);
gboolean    gtk_icon_view_get_reorderable   (gtkiconview *icon_view);
void        gtk_icon_view_set_drag_dest_item

                                            (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gtkiconviewdropposition pos);
void        gtk_icon_view_get_drag_dest_item
                                            (gtkiconview *icon_view,
                                             gtktreepath **path,
                                             gtkiconviewdropposition *pos);

gboolean    gtk_icon_view_get_dest_item_at_pos
                                            (gtkiconview *icon_view,
                                             gint drag_x,
                                             gint drag_y,
                                             gtktreepath **path,
                                             gtkiconviewdropposition *pos);

gdkpixmap*  gtk_icon_view_create_drag_icon  (gtkiconview *icon_view,
                                             gtktreepath *path);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer

                           +----gtkiconview

осуществляемые интерфейсы

gtkiconview осуществляет atkimplementoriface и gtkcelllayout.

свойства

  "column-spacing"       gint                  : read / write
  "columns"              gint                  : read / write
  "item-width"           gint                  : read / write
  "margin"               gint                  : read / write
  "markup-column"        gint                  : read / write
  "model"                gtktreemodel          : read / write
  "orientation"          gtkorientation        : read / write
  "pixbuf-column"        gint                  : read / write
  "reorderable"          gboolean              : read / write
  "row-spacing"          gint                  : read / write
  "selection-mode"       gtkselectionmode      : read / write
  "spacing"              gint                  : read / write
  "text-column"          gint                  : read / write

свойства стиля

  "selection-box-alpha"  guchar                : read
  "selection-box-color"  gdkcolor              : read

сигналы

"activate-cursor-item"
            gboolean    user_function      (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action
"item-activated"
            void        user_function      (gtkiconview *iconview,
                                            gtktreepath *arg1,
                                            gpointer     user_data)      : run last
"move-cursor"
            gboolean    user_function      (gtkiconview     *iconview,
                                            gtkmovementstep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : run last / action
"select-all"
            void        user_function      (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action
"select-cursor-item"
            void        user_function      (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action
"selection-changed"
            void        user_function      (gtkiconview *iconview,
                                            gpointer     user_data)      : run first
"set-scroll-adjustments"
            void        user_function      (gtkiconview   *iconview,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last
"toggle-cursor-item"
            void        user_function      (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action
"unselect-all"
            void        user_function      (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action

описание

gtkiconview обеспечивает альтернативный просмотр относительно модели списка. он отображает модель как сетку значков с ярлыками. как и gtktreeview, он позволяет выбирать один или несколько пунктов (зависит от режима выбора, смотрите gtk_icon_view_set_selection_mode()). в дополнение к выбору с помощью клавиш стрелок, gtkiconview поддерживает эластичное выделение, которое контролируется перетаскиванием указателя.

детали

gtkiconview

typedef struct _gtkiconview gtkiconview;

структура gtkiconview содержит только закрытые данные без непосредственного доступа.

gtkiconviewforeachfunc ()

void        (*gtkiconviewforeachfunc)       (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gpointer data);

функция используемая gtk_icon_view_selected_foreach() для отображения всех выделенных строк. она вызывается на каждой выделенной строке в просмотре.

`icon_view` :	gtkiconview
`path` :	gtktreepath выделенной строки
`data` :	пользовательские данные

gtk_icon_view_new ()

gtkwidget*  gtk_icon_view_new               (void);

создаёт новый gtkiconview виджет

возвращает :

вновь созданный gtkiconview виджет

начиная с версии 2.6

gtk_icon_view_new_with_model ()

gtkwidget*  gtk_icon_view_new_with_model    (gtktreemodel *model);

создаёт новый виджет gtkiconview с моделью model.

`model` :	модель.
возвращает :	вновь созданный виджет gtkiconview.

начиная с версии 2.6

gtk_icon_view_set_model ()

void        gtk_icon_view_set_model         (gtkiconview *icon_view,
                                             gtktreemodel *model);

устанавливает модель для gtkiconview. если icon_view уже имеет установленную модель, она переписывается новой. если model равно null, то когда просто удаляется предустановленная модель.

`icon_view` :	gtkiconview.
`model` :	модель.

начиная с версии 2.6

gtk_icon_view_get_model ()

gtktreemodel* gtk_icon_view_get_model       (gtkiconview *icon_view);

возвращает модель на которой основан gtkiconview. возвращает null если модель не установлена.

`icon_view` :	gtkiconview
возвращает :	gtktreemodel, или `null` если нет текущемй используемой модели.

начиная с версии 2.6

gtk_icon_view_set_text_column ()

void        gtk_icon_view_set_text_column   (gtkiconview *icon_view,
                                             gint column);

устанавливает столбец с текстом для icon_view равный column. текст столбца должен иметь тип g_type_string.

`icon_view` :	gtkiconview.
`column` :	столбец в текущемй используемой модели.

начиная с версии 2.6

gtk_icon_view_get_text_column ()

gint        gtk_icon_view_get_text_column   (gtkiconview *icon_view);

возвращает текст столбца для icon_view.

`icon_view` :	gtkiconview.
возвращает :	текст столбца, или -1 если он не установлен.

начиная с версии 2.6

gtk_icon_view_set_markup_column ()

void        gtk_icon_view_set_markup_column (gtkiconview *icon_view,
                                             gint column);

устанавливает столбец с информацией разметки для icon_view равный column. столбец разметки должен иметь тип g_type_string. если столбец разметки установлен, он отменяет столбец текста установленный с помощью gtk_icon_view_set_text_column().

`icon_view` :	gtkiconview.
`column` :	столбец в текущемй используемой модели.

начиная с версии 2.6

gtk_icon_view_get_markup_column ()

gint        gtk_icon_view_get_markup_column (gtkiconview *icon_view);

возвращает столбец с размеченным текстом для icon_view.

`icon_view` :	gtkiconview.
возвращает :	столбец разметки, или -1 если он не установлен.

начиная с версии 2.6

gtk_icon_view_set_pixbuf_column ()

void        gtk_icon_view_set_pixbuf_column (gtkiconview *icon_view,
                                             gint column);

устанавливает столбец с изображением для icon_view в значение column. столбец изображения должен иметь тип gdk_type_pixbuf

`icon_view` :	gtkiconview.
`column` :	столбец в текущемй используемой модели.

начиная с версии 2.6

gtk_icon_view_get_pixbuf_column ()

gint        gtk_icon_view_get_pixbuf_column (gtkiconview *icon_view);

возвращает столбец с изображением для icon_view.

`icon_view` :	gtkiconview.
возвращает :	столбец изображения, или -1 если не установлен.

начиная с версии 2.6

gtk_icon_view_get_path_at_pos ()

gtktreepath* gtk_icon_view_get_path_at_pos  (gtkiconview *icon_view,
                                             gint x,
                                             gint y);

находит путь указанный точками (x, y), относительно координат виджета. смотрите gtk_icon_view_get_item_at_pos(), если вас так же интересует ячейка в указанной позиции.

`icon_view` :	gtkiconview.
`x` :	x позиция для идентификации
`y` :	y позиция для идентификации
возвращает :	gtktreepath соответствующий значку или `null` если нет значка в этой позиции.

начиная с версии 2.6

gtk_icon_view_get_item_at_pos ()

gboolean    gtk_icon_view_get_item_at_pos   (gtkiconview *icon_view,
                                             gint x,
                                             gint y,
                                             gtktreepath **path,
                                             gtkcellrenderer **cell);

находит путь указанный точками (x, y), относительно координат виджета. в отличии от gtk_icon_view_get_path_at_pos(), эта функция также определяет ячейку в указанной позиции. возвращаемый путь должен освобождаться с помощью gtk_tree_path_free().

`icon_view` :	gtkiconview.
`x` :	x позиция для идентификации
`y` :	y позиция для идентификации
`path` :	путь, или `null`
`cell` :	ячейка в позиции (`x`, `y`), или `null`
возвращает :	`true` если элемент существует в указанной позиции

начиная с версии 2.8

gtk_icon_view_set_cursor ()

void        gtk_icon_view_set_cursor        (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gtkcellrenderer *cell,
                                             gboolean start_editing);

устанавливает текущий клавиатурный фокус в позицию path, и выделяет её. это полезно когда вам нужно привлечь внимание пользователя на специальную ячейку. если cell не null, то фокус получает определенная им ячейка. дополнительно, если start_editing это true, то редактирование должно начинаться в определенной ячейки.

эта функция часто сопровождается gtk_widget_grab_focus (icon_view) чтобы предоставить клавиатурный фокус виджету. пожалуйста помните что редактирование возможно только когда виджет реализован.

`icon_view` :	gtkiconview
`path` :	gtktreepath
`cell` :	одна из отображаемых ячеек `icon_view`, или `null`
`start_editing` :	`true` если редактирование должно начинаться в определенной ячейке.

начиная с версии 2.8

gtk_icon_view_get_cursor ()

gboolean    gtk_icon_view_get_cursor        (gtkiconview *icon_view,
                                             gtktreepath **path,
                                             gtkcellrenderer **cell);

заполняет path и cell текущим путем и ячейкой курсора. если текущий курсор не установлен, то *path будет null. если нет ячейки с текущим фокусом, то *cell будет null.

возвращаемый gtktreepath должен освобождаться с помощью gtk_tree_path_free().

`icon_view` :	gtkiconview
`path` :	текущий путь курсора, или `null`
`cell` :	текущая ячейка в фокусе, или `null`
возвращает :	`true` если курсор установлен.

начиная с версии 2.8

gtk_icon_view_selected_foreach ()

void        gtk_icon_view_selected_foreach  (gtkiconview *icon_view,
                                             gtkiconviewforeachfunc func,
                                             gpointer data);

вызывает функцию для каждого вызванного значка. помните что модель или выделение не должны изменяться внутри этой функции.

`icon_view` :	gtkiconview.
`func` :	функция вызываемая для каждого выбранного значка.
`data` :	пользовательские данные помещаемые в функцию.

начиная с версии 2.6

gtk_icon_view_set_selection_mode ()

void        gtk_icon_view_set_selection_mode
                                            (gtkiconview *icon_view,
                                             gtkselectionmode mode);

устанавливает режим выделения icon_view.

`icon_view` :	gtkiconview.
`mode` :	режим выделения

начиная с версии 2.6

gtk_icon_view_get_selection_mode ()

gtkselectionmode gtk_icon_view_get_selection_mode
                                            (gtkiconview *icon_view);

выдаёт режим выделения icon_view.

`icon_view` :	gtkiconview.
возвращает :	текущий режим выделения

начиная с версии 2.6

gtk_icon_view_set_orientation ()

void        gtk_icon_view_set_orientation   (gtkiconview *icon_view,
                                             gtkorientation orientation);

устанавливает свойство ::orientation которое определяет отображаются ли ярлыки рядом со значками или под ними.

`icon_view` :	gtkiconview
`orientation` :	относительная позиция текста и значков

начиная с версии 2.6

gtk_icon_view_get_orientation ()

gtkorientation gtk_icon_view_get_orientation
                                            (gtkiconview *icon_view);

возвращает значение свойства ::orientation которое определяет отображаются ли ярлыки рядом со значками или под ними.

`icon_view` :	gtkiconview
возвращает :	относительная позиция текста и значков

начиная с версии 2.6

gtk_icon_view_set_columns ()

void        gtk_icon_view_set_columns       (gtkiconview *icon_view,
                                             gint columns);

устанавливает свойство ::columns которое определяет в каком количестве столбцов распределяются значки. если columns равно -1, количество столбцов выбирается автоматически для заполнения всей доступной площади.

`icon_view` :	gtkiconview
`columns` :	количество столбцов

начиная с версии 2.6

gtk_icon_view_get_columns ()

gint        gtk_icon_view_get_columns       (gtkiconview *icon_view);

возвращает значение свойства ::columns.

`icon_view` :	gtkiconview
возвращает :	количество столбцов, или -1

начиная с версии 2.6

gtk_icon_view_set_item_width ()

void        gtk_icon_view_set_item_width    (gtkiconview *icon_view,
                                             gint item_width);

устанавливает свойство ::item-width которое определяет ширину используемую для каждого элемента. если оно установлено равным -1, просмотр значков автоматически определит подходящий размер элементов.

`icon_view` :	gtkiconview
`item_width` :	ширина каждого элемента

начиная с версии 2.6

gtk_icon_view_get_item_width ()

gint        gtk_icon_view_get_item_width    (gtkiconview *icon_view);

возвращает значение свойства ::item-width.

`icon_view` :	gtkiconview
возвращает :	ширина единственного элемента, или -1

начиная с версии 2.6

gtk_icon_view_set_spacing ()

void        gtk_icon_view_set_spacing       (gtkiconview *icon_view,
                                             gint spacing);

устанавливает свойство ::spacing которое определяет интервал между ячейками (то есть значок и текст) элементов.

`icon_view` :	gtkiconview
`spacing` :	интервал

начиная с версии 2.6

gtk_icon_view_get_spacing ()

gint        gtk_icon_view_get_spacing       (gtkiconview *icon_view);

возвращает значение свойства ::spacing.

`icon_view` :	gtkiconview
возвращает :	интервал между ячейками

начиная с версии 2.6

gtk_icon_view_set_row_spacing ()

void        gtk_icon_view_set_row_spacing   (gtkiconview *icon_view,
                                             gint row_spacing);

устанавливает свойство ::row-spacing которое определяет интервал между строками просмотра значков.

`icon_view` :	gtkiconview
`row_spacing` :	строковый интервал

начиная с версии 2.6

gtk_icon_view_get_row_spacing ()

gint        gtk_icon_view_get_row_spacing   (gtkiconview *icon_view);

возвращает значение свойства ::row-spacing.

`icon_view` :	gtkiconview
возвращает :	интервал между строками

начиная с версии 2.6

gtk_icon_view_set_column_spacing ()

void        gtk_icon_view_set_column_spacing
                                            (gtkiconview *icon_view,
                                             gint column_spacing);

устанавливает свойство ::column-spacing которое определяет интервал между столбцами в просмотре значков.

`icon_view` :	gtkiconview
`column_spacing` :	интервал между столбцами

начиная с версии 2.6

gtk_icon_view_get_column_spacing ()

gint        gtk_icon_view_get_column_spacing
                                            (gtkiconview *icon_view);

возвращает значение свойства ::column-spacing.

`icon_view` :	gtkiconview
возвращает :	интервал между столбцами

начиная с версии 2.6

gtk_icon_view_set_margin ()

void        gtk_icon_view_set_margin        (gtkiconview *icon_view,
                                             gint margin);

устанавливает свойство ::margin которое определяет интервал сверху, снизу, справа и слева просмотра значков.

`icon_view` :	gtkiconview
`margin` :	граница

начиная с версии 2.6

gtk_icon_view_get_margin ()

gint        gtk_icon_view_get_margin        (gtkiconview *icon_view);

возвращает значение свойства ::margin.

`icon_view` :	gtkiconview
возвращает :	интервал границ

начиная с версии 2.6

gtk_icon_view_select_path ()

void        gtk_icon_view_select_path       (gtkiconview *icon_view,
                                             gtktreepath *path);

выбирает строку в path.

`icon_view` :	gtkiconview.
`path` :	gtktreepath для выбора.

начиная с версии 2.6

gtk_icon_view_unselect_path ()

void        gtk_icon_view_unselect_path     (gtkiconview *icon_view,
                                             gtktreepath *path);

снимает выделение строки path.

`icon_view` :	gtkiconview.
`path` :	gtktreepath для снятия выделения.

начиная с версии 2.6

gtk_icon_view_path_is_selected ()

gboolean    gtk_icon_view_path_is_selected  (gtkiconview *icon_view,
                                             gtktreepath *path);

возвращает true если значок указанный path в текущий момент выделен. если icon не доступен, возвращается false.

`icon_view` :	gtkiconview.
`path` :	gtktreepath для контроля выбора.
возвращает :	`true` если `path` выбран.

начиная с версии 2.6

gtk_icon_view_get_selected_items ()

glist*      gtk_icon_view_get_selected_items
                                            (gtkiconview *icon_view);

создаёт список путей всех выделенных элементов. дополнительно, если вы планируете модифицировать модель после вызова этой функции, вы можете конвертировать возвращаемый список в список gtktreerowreferences. для этого вы можете использовать gtk_tree_row_reference_new().

для освобождения возвращённых значений используйте:

g_list_foreach (list, gtk_tree_path_free, null);
g_list_free (list);

`icon_view` :	gtkiconview.
возвращает :	glist содержащий gtktreepath для каждой выделенной строки.

начиная с версии 2.6

gtk_icon_view_select_all ()

void        gtk_icon_view_select_all        (gtkiconview *icon_view);

выделяет все значки. icon_view должен иметь режим выделения установленный в значение gtk_selection_multiple.

icon_view :

gtkiconview.

начиная с версии 2.6

gtk_icon_view_unselect_all ()

void        gtk_icon_view_unselect_all      (gtkiconview *icon_view);

снимает выделение всех значков.

icon_view :

gtkiconview.

начиная с версии 2.6

gtk_icon_view_item_activated ()

void        gtk_icon_view_item_activated    (gtkiconview *icon_view,
                                             gtktreepath *path);

активизирует элементы определенные параметром path.

`icon_view` :	gtkiconview
`path` :	gtktreepath для активизации

начиная с версии 2.6

gtk_icon_view_scroll_to_path ()

void        gtk_icon_view_scroll_to_path    (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);

перемещает выравнивание icon_view в позицию определённую параметром path. row_align определяет где размещается строка, а col_align определяет где размещается column. оба параметра располагаются в пределах между 0.0 и 1.0. 0.0 означает левое-верхнее выравнивание, 1.0 означает правое нижнее выравнивание, 0.5 означает центр.

если use_align равен false, то аргументы выравнивания игнорируются, а дерево выполняет минимум работы для прокручивания элементов на экране. это значит что элементы будут прокручены до самого ближнего края от текущемй позиции. если элементы в текущий момент видимы на экране, ничего не происходит.

эта функция работает только если установлена модель и path указывает доступную строку этой модели. если модель изменяется перед реализацией icon_view, центральный путь изменяется для отражения этих изменений.

`icon_view` :	gtkiconview.
`path` :	путь для перемещения элементов.
`use_align` :	используются ли аргументы выравнивания, или `false`.
`row_align` :	вертикальное выравнивание элементов определённых параметром `path`.
`col_align` :	горизонтальное выравнивание элементов определённых параметром `path`.

начиная с версии 2.8

gtk_icon_view_get_visible_range ()

gboolean    gtk_icon_view_get_visible_range (gtkiconview *icon_view,
                                             gtktreepath **start_path,
                                             gtktreepath **end_path);

устанавливает start_path и end_path для первого и последнего видимого пути. помните что между ними могут быть невидимые пути.

пути должны освобождаться с помощью gtk_tree_path_free() после использования.

`icon_view` :	gtkiconview
`start_path` :	начало диапазона, или `null`
`end_path` :	конец диапазона, или `null`
возвращает :	`true`, если доступные пути размещены в параметры `start_path` и `end_path`

начиная с версии 2.8

enum gtkiconviewdropposition

typedef enum
{
  gtk_icon_view_no_drop,
  gtk_icon_view_drop_into,
  gtk_icon_view_drop_left,
  gtk_icon_view_drop_right,
  gtk_icon_view_drop_above,
  gtk_icon_view_drop_below
} gtkiconviewdropposition;

перечисление для определения куда направляется перемещаемый элемент.

`gtk_icon_view_no_drop`	перетаскивание не возможно
`gtk_icon_view_drop_into`	перетаскиваемый элемент замещает элемент
`gtk_icon_view_drop_left`	перетаскиваемый элемент вставляется слева
`gtk_icon_view_drop_right`	перетаскиваемый элемент вставляется справа
`gtk_icon_view_drop_above`	перетаскиваемый элемент вставляется выше
`gtk_icon_view_drop_below`	перетаскиваемый элемент вставляется ниже

gtk_icon_view_enable_model_drag_source ()

void        gtk_icon_view_enable_model_drag_source
                                            (gtkiconview *icon_view,
                                             gdkmodifiertype start_button_mask,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);

интерпретирует icon_view в источник перетаскивания для автоматического dnd.

`icon_view` :	gtkicontreeview
`start_button_mask` :	маска допустимых кнопок для начала перетаскивания
`targets` :	таблица целей которые поддерживают перетаскивание
`n_targets` :	количество элементов в `targets`
`actions` :	битовая маска возможных действий для перетаскивания из этого виджета

начиная с версии 2.8

gtk_icon_view_enable_model_drag_dest ()

void        gtk_icon_view_enable_model_drag_dest
                                            (gtkiconview *icon_view,
                                             const gtktargetentry *targets,
                                             gint n_targets,
                                             gdkdragaction actions);

интерпретирует icon_view в адресат перетаскивания для автоматического dnd.

`icon_view` :	gtkiconview
`targets` :	таблица целей которые поддерживают перетаскивание
`n_targets` :	количество элементов в targets
`actions` :	битовая маска возможных действий для перетаскивания из этого виджета

начиная с версии 2.8

gtk_icon_view_unset_model_drag_source ()

void        gtk_icon_view_unset_model_drag_source
                                            (gtkiconview *icon_view);

отменяет действие функции gtk_icon_view_enable_model_drag_source().

icon_view :

gtkiconview

начиная с версии 2.8

gtk_icon_view_unset_model_drag_dest ()

void        gtk_icon_view_unset_model_drag_dest
                                            (gtkiconview *icon_view);

отменяет действие функции gtk_icon_view_enable_model_drag_dest().

icon_view :

gtkiconview

начиная с версии 2.8

gtk_icon_view_set_reorderable ()

void        gtk_icon_view_set_reorderable   (gtkiconview *icon_view,
                                             gboolean reorderable);

это удобная функция для переупорядочивания моделей поддерживающих gtktreedragsourceiface и gtktreedragdestiface. и gtktreestore и gtkliststore поддерживают их. если reorderable равен true, то пользователь может пере-упорядочивать модель перетаскиванием строк. разработчик может контролировать эти изменения модели подключив сигналы row_inserted и row_deleted.

эта функция не даёт вам никакого контроля над порядком – любое переупорядочивание допустимо. если вам нужно больше контроля, вы должны обрабатывать drag and drop самостоятельно.

`icon_view` :	gtkiconview.
`reorderable` :	`true`, если список элементов может быть переупорядочен.

начиная с версии 2.8

gtk_icon_view_get_reorderable ()

gboolean    gtk_icon_view_get_reorderable   (gtkiconview *icon_view);

определяет может ли пользователь пере-упорядочивать список через drag-and-drop. смотрите gtk_icon_view_set_reorderable().

`icon_view` :	gtkiconview
возвращает :	`true` если список может быть переупорядочен.

начиная с версии 2.8

gtk_icon_view_set_drag_dest_item ()

void        gtk_icon_view_set_drag_dest_item
                                            (gtkiconview *icon_view,
                                             gtktreepath *path,
                                             gtkiconviewdropposition pos);

устанавливает элемент который подсвечивается для обратной связи.

`icon_view` :	gtkiconview
`path` :	путь элемента для подсвечивания, или `null`.
`pos` :	определяет позицию относительно элемента

начиная с версии 2.8

gtk_icon_view_get_drag_dest_item ()

void        gtk_icon_view_get_drag_dest_item
                                            (gtkiconview *icon_view,
                                             gtktreepath **path,
                                             gtkiconviewdropposition *pos);

получает информацию об элементе который подсвечивается для обратной связи.

`icon_view` :	gtkiconview
`path` :	путь подсвечиваемого элемента, или `null`.
`pos` :	позиция перемещения, или `null`

начиная с версии 2.8

gtk_icon_view_get_dest_item_at_pos ()

gboolean    gtk_icon_view_get_dest_item_at_pos
                                            (gtkiconview *icon_view,
                                             gint drag_x,
                                             gint drag_y,
                                             gtktreepath **path,
                                             gtkiconviewdropposition *pos);

определяет элемент адресата для данной позиции.

`icon_view` :	gtkiconview
`drag_x` :	позиция для определения элемента адресата
`drag_y` :	позиция для определения элемента адресата
`path` :	путь элемента, или `null`.
`pos` :	позиция перемещения, или `null`
возвращает :	есть ли элемент в данной позиции.

начиная с версии 2.8

gtk_icon_view_create_drag_icon ()

gdkpixmap*  gtk_icon_view_create_drag_icon  (gtkiconview *icon_view,
                                             gtktreepath *path);

создаёт gdkpixmap представляющий элемент в path. это изображение используется для значка перетаскивания.

`icon_view` :	gtkiconview
`path` :	gtktreepath в `icon_view`
возвращает :	вновь созданный значок перетаскивания.

начиная с версии 2.8

детали свойств

свойство "`column-spacing`"

  "column-spacing"       gint                  : read / write

интервал между столбцами сетки.

допустимые значения: >= 0

значение по умолчанию : 6

свойство "`columns`"

  "columns"              gint                  : read / write

свойство columns содержит количество столбцов в котором должны отображаться элементы. если оно равно -1, количество столбцов определяется автоматически для заполнения доступного пространства.

допустимые значения: >= -1

значение по умолчанию : -1

начиная с версии 2.6

свойство "`item-width`"

  "item-width"           gint                  : read / write

ширина каждого элемента.

допустимые значения: >= -1

значение по умолчанию : -1

свойство "`margin`"

  "margin"               gint                  : read / write

интервал между границами просмотра значков.

допустимые значения: >= 0

значение по умолчанию : 6

свойство "`markup-column`"

  "markup-column"        gint                  : read / write

свойство ::markup-column содержит количество столбцов модели содержащих информацию разметки для отображения. столбец разметки должен иметь тип g_type_string. если это свойство и свойство :text-column установлены оба в количество столбцов, оно отменяет текстовый столбец. если оба свойства установлены в -1, текст не отображается.

допустимые значения: >= -1

значение по умолчанию : -1

начиная с версии 2.6

свойство "`model`"

  "model"                gtktreemodel          : read / write

модель для просмотра значков.

свойство "`orientation`"

  "orientation"          gtkorientation        : read / write

как текст и значок располагаются относительно друг друга.

значение по умолчанию : gtk_orientation_vertical

свойство "`pixbuf-column`"

  "pixbuf-column"        gint                  : read / write

свойство ::pixbuf-column содержит количество столбцов модели содержащих изображения для отображения. столбец изображения должен иметь тип gdk_type_pixbuf. установка этого свойства в -1 отключает отображение изображений.

допустимые значения: >= -1

значение по умолчанию : -1

начиная с версии 2.6

свойство "`reorderable`"

  "reorderable"          gboolean              : read / write

свойство определяющее возможность переупорядочивания элементов с помощью dnd.

значение по умолчанию : false

начиная с версии 2.8

свойство "`row-spacing`"

  "row-spacing"          gint                  : read / write

интервал между строками сетки.

допустимые значения: >= 0

значение по умолчанию : 6

свойство "`selection-mode`"

  "selection-mode"       gtkselectionmode      : read / write

свойство ::selection-mode определяет режим выделения просмотра значков. если режим gtk_selection_multiple, эластичное выделение включено, для других режимов возможно только клавиатурное выделение.

значение по умолчанию : gtk_selection_single

начиная с версии 2.6

свойство "`spacing`"

  "spacing"              gint                  : read / write

интервал между ячейками элементов.

допустимые значения: >= 0

значение по умолчанию : 0

свойство "`text-column`"

  "text-column"          gint                  : read / write

свойство ::text-column содержит количество столбцов модели содержащих текст для отображения. текстовый столбец должен иметь тип g_type_string. если это свойство и свойство :markup-column оба установлены в -1, текст не отображается.

допустимые значения: >= -1

значение по умолчанию : -1

начиная с версии 2.6

детали свойств стиля

свойство стиля "`selection-box-alpha`"

  "selection-box-alpha"  guchar                : read

затенение контейнера выделения.

значение по умолчанию : 64

свойство стиля "`selection-box-color`"

  "selection-box-color"  gdkcolor              : read

цвет контейнера выделения.

детали сигналов

сигнал "activate-cursor-item"

gboolean    user_function                  (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action

`iconview` :	объект получающий сигнал.
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.
возвращает :

сигнал "item-activated"

void        user_function                  (gtkiconview *iconview,
                                            gtktreepath *arg1,
                                            gpointer     user_data)      : run last

`iconview` :	объект получающий сигнал.
`arg1` :
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

сигнал "move-cursor"

gboolean    user_function                  (gtkiconview     *iconview,
                                            gtkmovementstep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : run last / action

`iconview` :	объект получающий сигнал.
`arg1` :
`arg2` :
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.
возвращает :

сигнал "select-all"

void        user_function                  (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action

`iconview` :	объект получающий сигнал.
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

сигнал "select-cursor-item"

void        user_function                  (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action

`iconview` :	объект получающий сигнал.
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

сигнал "selection-changed"

void        user_function                  (gtkiconview *iconview,
                                            gpointer     user_data)      : run first

`iconview` :	объект получающий сигнал.
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

сигнал "set-scroll-adjustments"

void        user_function                  (gtkiconview   *iconview,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last

`iconview` :	объект получающий сигнал.
`arg1` :
`arg2` :
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

сигнал "toggle-cursor-item"

void        user_function                  (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action

`iconview` :	объект получающий сигнал.
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

сигнал "unselect-all"

void        user_function                  (gtkiconview *iconview,
                                            gpointer     user_data)      : run last / action

`iconview` :	объект получающий сигнал.
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

gtkiconview

краткое описание

иерархия объектов

осуществляемые интерфейсы

свойства

свойства стиля

сигналы

описание

детали

gtkiconview

gtkiconviewforeachfunc ()

gtk_icon_view_new ()

gtk_icon_view_new_with_model ()

gtk_icon_view_set_model ()

gtk_icon_view_get_model ()

gtk_icon_view_set_text_column ()

gtk_icon_view_get_text_column ()

gtk_icon_view_set_markup_column ()

gtk_icon_view_get_markup_column ()

gtk_icon_view_set_pixbuf_column ()

gtk_icon_view_get_pixbuf_column ()

gtk_icon_view_get_path_at_pos ()

gtk_icon_view_get_item_at_pos ()

gtk_icon_view_set_cursor ()

gtk_icon_view_get_cursor ()

gtk_icon_view_selected_foreach ()

gtk_icon_view_set_selection_mode ()

gtk_icon_view_get_selection_mode ()

gtk_icon_view_set_orientation ()

gtk_icon_view_get_orientation ()

gtk_icon_view_set_columns ()

gtk_icon_view_get_columns ()

gtk_icon_view_set_item_width ()

gtk_icon_view_get_item_width ()

gtk_icon_view_set_spacing ()

gtk_icon_view_get_spacing ()

gtk_icon_view_set_row_spacing ()

gtk_icon_view_get_row_spacing ()

gtk_icon_view_set_column_spacing ()

gtk_icon_view_get_column_spacing ()

gtk_icon_view_set_margin ()

gtk_icon_view_get_margin ()

gtk_icon_view_select_path ()

gtk_icon_view_unselect_path ()

gtk_icon_view_path_is_selected ()

gtk_icon_view_get_selected_items ()

gtk_icon_view_select_all ()

gtk_icon_view_unselect_all ()

gtk_icon_view_item_activated ()

gtk_icon_view_scroll_to_path ()

gtk_icon_view_get_visible_range ()

enum gtkiconviewdropposition

gtk_icon_view_enable_model_drag_source ()

gtk_icon_view_enable_model_drag_dest ()

gtk_icon_view_unset_model_drag_source ()

gtk_icon_view_unset_model_drag_dest ()

gtk_icon_view_set_reorderable ()

gtk_icon_view_get_reorderable ()

gtk_icon_view_set_drag_dest_item ()

gtk_icon_view_get_drag_dest_item ()

gtk_icon_view_get_dest_item_at_pos ()

gtk_icon_view_create_drag_icon ()

детали свойств

свойство "column-spacing"

свойство "columns"

свойство "item-width"

свойство "margin"

свойство "markup-column"

свойство "model"

свойство "orientation"

свойство "pixbuf-column"

свойство "reorderable"

свойство "row-spacing"

свойство "selection-mode"

свойство "spacing"

свойство "text-column"

детали свойств стиля

свойство стиля "selection-box-alpha"

свойство стиля "selection-box-color"

детали сигналов

свойство "`column-spacing`"

свойство "`columns`"

свойство "`item-width`"

свойство "`margin`"

свойство "`markup-column`"

свойство "`model`"

свойство "`orientation`"

свойство "`pixbuf-column`"

свойство "`reorderable`"

свойство "`row-spacing`"

свойство "`selection-mode`"

свойство "`spacing`"

свойство "`text-column`"

свойство стиля "`selection-box-alpha`"

свойство стиля "`selection-box-color`"