Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Style Properties  |  Signals

GtkIconView

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 :

пользовательские данные помещаемые при подключении обработчика сигнала.