GtkIconView

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

			GTK+ Reference Manual
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` :	пользовательские данные помещаемые при подключении обработчика сигнала.

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2025 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

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`"