GtkIconView

GtkIconViewForeachFunc ()

void
(*GtkIconViewForeachFunc) (GtkIconView *icon_view,
                           GtkTreePath *path,
                           gpointer data);

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

gtk_icon_view_new ()

GtkWidget *
gtk_icon_view_new (void);

Создаёт новый виджет GtkIconView

gtk_icon_view_new_with_area ()

GtkWidget *
gtk_icon_view_new_with_area (GtkCellArea *area);

Создаёт новый виджет GtkIconView с использованием указанного area для выравнивания ячеек внутри значков.

gtk_icon_view_new_with_model ()

GtkWidget *
gtk_icon_view_new_with_model (GtkTreeModel *model);

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

gtk_icon_view_set_model ()

void
gtk_icon_view_set_model (GtkIconView *icon_view,
                         GtkTreeModel *model);

Устанавливает модель для GtkIconView. Если у icon_view уже установлена модель, она будет удалена перед установкой новой модели. Если model является NULL, то предыдущая модель будет удалена.

gtk_icon_view_get_model ()

GtkTreeModel *
gtk_icon_view_get_model (GtkIconView *icon_view);

Возвращает модель, на которой основан GtkIconView. Возвращает NULL если модель не установлена.

gtk_icon_view_set_text_column ()

void
gtk_icon_view_set_text_column (GtkIconView *icon_view,
                               int column);

Устанавливает колонку с текстом для icon_view в column . Колонка текста должна иметь тип G_TYPE_STRING.

gtk_icon_view_get_text_column ()

int
gtk_icon_view_get_text_column (GtkIconView *icon_view);

Возвращает колонку с текстом для icon_view.

gtk_icon_view_set_markup_column ()

void
gtk_icon_view_set_markup_column (GtkIconView *icon_view,
                                 int column);

Устанавливает колонку с разметкой для icon_view в column . Колонка разметки должна иметь тип G_TYPE_STRING. Если колонка разметки установлена, она переопределяет колонку текста, установленную с помощью gtk_icon_view_set_text_column().

gtk_icon_view_get_markup_column ()

int
gtk_icon_view_get_markup_column (GtkIconView *icon_view);

Возвращает колонку с разметкой для icon_view.

gtk_icon_view_set_pixbuf_column ()

void
gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view,
                                 int column);

Устанавливает колонку с пикбуфами для icon_view в column. Колонка пикбуфов должна иметь тип GDK_TYPE_PIXBUF

gtk_icon_view_get_pixbuf_column ()

int
gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view);

Возвращает колонку с пикбуфами для icon_view.

gtk_icon_view_get_path_at_pos ()

GtkTreePath *
gtk_icon_view_get_path_at_pos (GtkIconView *icon_view,
                               int x,
                               int y);

Получает путь к значку в заданной позиции.

gtk_icon_view_get_item_at_pos ()

gboolean
gtk_icon_view_get_item_at_pos (GtkIconView *icon_view,
                               int x,
                               int y,
                               GtkTreePath **path,
                               GtkCellRenderer **cell);

Получает путь и ячейку для значка в заданной позиции.

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) для присвоения фокуса клавиатуры виджету. Обратите внимание, что редактирование возможно только при отображении виджета.

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().

gtk_icon_view_selected_foreach ()

void
gtk_icon_view_selected_foreach (GtkIconView *icon_view,
                                GtkIconViewForeachFunc func,
                                gpointer data);

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

gtk_icon_view_set_selection_mode ()

void
gtk_icon_view_set_selection_mode (GtkIconView *icon_view,
                                  GtkSelectionMode mode);

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

gtk_icon_view_get_selection_mode ()

GtkSelectionMode
gtk_icon_view_get_selection_mode (GtkIconView *icon_view);

Получает режим выбора icon_view .

gtk_icon_view_set_item_orientation ()

void
gtk_icon_view_set_item_orientation (GtkIconView *icon_view,
                                    GtkOrientation orientation);

Устанавливает свойство ::item-orientation, которое определяет, выводятся ли метки рядом со значками, а не под ними.

gtk_icon_view_get_item_orientation ()

GtkOrientation
gtk_icon_view_get_item_orientation (GtkIconView *icon_view);

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

gtk_icon_view_set_columns ()

void
gtk_icon_view_set_columns (GtkIconView *icon_view,
                           int columns);

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

gtk_icon_view_get_columns ()

int
gtk_icon_view_get_columns (GtkIconView *icon_view);

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

gtk_icon_view_set_item_width ()

void
gtk_icon_view_set_item_width (GtkIconView *icon_view,
                              int item_width);

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

gtk_icon_view_get_item_width ()

int
gtk_icon_view_get_item_width (GtkIconView *icon_view);

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

gtk_icon_view_set_spacing ()

void
gtk_icon_view_set_spacing (GtkIconView *icon_view,
                           int spacing);

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

gtk_icon_view_get_spacing ()

int
gtk_icon_view_get_spacing (GtkIconView *icon_view);

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

gtk_icon_view_set_row_spacing ()

void
gtk_icon_view_set_row_spacing (GtkIconView *icon_view,
                               int row_spacing);

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

gtk_icon_view_get_row_spacing ()

int
gtk_icon_view_get_row_spacing (GtkIconView *icon_view);

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

gtk_icon_view_set_column_spacing ()

void
gtk_icon_view_set_column_spacing (GtkIconView *icon_view,
                                  int column_spacing);

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

gtk_icon_view_get_column_spacing ()

int
gtk_icon_view_get_column_spacing (GtkIconView *icon_view);

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

gtk_icon_view_set_margin ()

void
gtk_icon_view_set_margin (GtkIconView *icon_view,
                          int margin);

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

gtk_icon_view_get_margin ()

int
gtk_icon_view_get_margin (GtkIconView *icon_view);

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

gtk_icon_view_set_item_padding ()

void
gtk_icon_view_set_item_padding (GtkIconView *icon_view,
                                int item_padding);

Устанавливает свойство “item-padding”, которое задаёт отступ вокруг каждого элемента представления значков.

gtk_icon_view_get_item_padding ()

int
gtk_icon_view_get_item_padding (GtkIconView *icon_view);

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

gtk_icon_view_set_activate_on_single-click ()

void
gtk_icon_view_set_activate_on_single_click
                               (GtkIconView *icon_view,
                                gboolean single);

Вызывает генерацию сигнала “item-activated” при одиночном щелчке вместо двойного.

gtk_icon_view_get_activate_on_single_click ()

gboolean
gtk_icon_view_get_activate_on_single_click
                               (GtkIconView *icon_view);

Получает значение, установленное функцией gtk_icon_view_set_activate_on_single_click().

gtk_icon_view_get_cell_rect ()

gboolean
gtk_icon_view_get_cell_rect (GtkIconView *icon_view,
                             GtkTreePath *path,
                             GtkCellRenderer *cell,
                             GdkRectangle *rect);

Заполняет прямоугольник, определяющий область ячейки в координатах виджета, заданной параметрами path и cell . Если cell равно NULL, используется основная область ячейки.

Эта функция работает только если виджет icon_view реализован.

gtk_icon_view_select_path ()

void
gtk_icon_view_select_path (GtkIconView *icon_view,
                           GtkTreePath *path);

Выделяет строку по path .

gtk_icon_view_unselect-path ()

void
gtk_icon_view_unselect_path (GtkIconView *icon_view,
                             GtkTreePath *path);

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

gtk_icon_view_path_is_selected ()

gboolean
gtk_icon_view_path_is_selected (GtkIconView *icon_view,
                                GtkTreePath *path);

Возвращает TRUE, если значок, на который указывает path, в данный момент выделен. Если path не указывает на действительное местоположение, возвращается FALSE.

gtk_icon_view_get_selected_items ()

GList *
gtk_icon_view_get_selected_items (GtkIconView *icon_view);

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

Для освобождения возвращаемого значения используйте:

iconview.view
╰── [rubberband]

gtk_icon_view_select_all ()

void
gtk_icon_view_select_all (GtkIconView *icon_view);

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

gtk_icon_view_unselect-all ()

void
gtk_icon_view_unselect_all (GtkIconView *icon_view);

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

gtk_icon_view_item_activated ()

void
gtk_icon_view_item_activated (GtkIconView *icon_view,
                              GtkTreePath *path);

Активирует элемент, определённый path.

gtk_icon_view_scroll-to-path ()

void
gtk_icon_view_scroll_to_path (GtkIconView *icon_view,
                              GtkTreePath *path,
                              gboolean use_align,
                              float row_align,
                              float 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 будет реализована, путь к центру будет изменён, чтобы отразить это изменение.

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() после использования.

gtk_icon_view_set_tooltip_item ()

void
gtk_icon_view_set_tooltip_item (GtkIconView *icon_view,
                                GtkTooltip *tooltip,
                                GtkTreePath *path);

Устанавливает область подсказки tooltip на область, покрываемую элементом в path. Также см. gtk_icon_view_set_tooltip_column() для более простого варианта. Также см. gtk_tooltip_set_tip_area().

gtk_icon_view_set_tooltip_cell ()

void
gtk_icon_view_set_tooltip_cell (GtkIconView *icon_view,
                                GtkTooltip *tooltip,
                                GtkTreePath *path,
                                GtkCellRenderer *cell);

Устанавливает область подсказки tooltip на область, занимаемую cell в элементе, на который указывает path. Также см. gtk_tooltip_set_tip_area().

Также см. gtk_icon_view_set_tooltip_column() для более простого варианта.

gtk_icon_view_get_tooltip_context ()

gboolean
gtk_icon_view_get_tooltip_context (GtkIconView *icon_view,
                                   int x,
                                   int y,
                                   gboolean keyboard_tip,
                                   GtkTreeModel **model,
                                   GtkTreePath **path,
                                   GtkTreeIter *iter);

Эта функция предназначена для использования в обработчике сигнала “query-tooltip” для GtkIconView. Значения x, y и keyboard_tip, полученные в обработчике сигнала, должны быть переданы в эту функцию без изменений.

Возвращаемое значение указывает, есть ли элемент представления значка по заданным координатам (TRUE) или нет (FALSE) для всплывающих подсказок мыши. Для всплывающих подсказок клавиатуры возвращаемым элементом будет элемент курсора. Если TRUE, то любое из model, path и iter, предоставленных значений, будет установлено для указания на этот ряд и соответствующей модели.

gtk_icon_view_set_tooltip_column ()

void
gtk_icon_view_set_tooltip_column (GtkIconView *icon_view,
                                  int column);

Если вы планируете иметь простые (только текстовые) всплывающие подсказки для полных элементов, вы можете использовать эту функцию, чтобы GtkIconView обрабатывал их автоматически за вас. column должен быть установлен на столбец в модели icon_view, содержащий тексты всплывающих подсказок, или -1 для отключения этой функции.

При включении “has-tooltip” будет установлено в TRUE и icon_view будет подключен обработчик сигнала “query-tooltip”.

Обратите внимание, что обработчик сигнала устанавливает текст с помощью gtk_tooltip_set_markup(), поэтому &, < и т. д. должны быть экранированы в тексте.

gtk_icon_view_get_tooltip_column ()

int
gtk_icon_view_get_tooltip_column (GtkIconView *icon_view);

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

gtk_icon_view_get_item_row ()

int
gtk_icon_view_get_item_row (GtkIconView *icon_view,
                            GtkTreePath *path);

Возвращает строку, в которой в данный момент отображается элемент path. Номера строк начинаются с 0.

gtk_icon_view_get_item_column ()

int
gtk_icon_view_get_item_column (GtkIconView *icon_view,
                               GtkTreePath *path);

Возвращает столбец, в котором в данный момент отображается элемент path. Номера столбцов начинаются с 0.

gtk_icon_view_enable_model_drag_source ()

void
gtk_icon_view_enable_model_drag_source
                               (GtkIconView *icon_view,
                                GdkModifierType start_button_mask,
                                GdkContentFormats *formats,
                                GdkDragAction actions);

Преобразует icon_view в источник перетаскивания для автоматического DND. Вызов этого метода устанавливает “reorderable” в FALSE.

gtk_icon_view_enable_model_drag_dest ()

void
gtk_icon_view_enable_model_drag_dest (GtkIconView *icon_view,
                                      GdkContentFormats *formats,
                                      GdkDragAction actions);

Преобразует icon_view в целевой объект для перетаскивания с автоматическим DND. Вызов этого метода устанавливает “reorderable” в FALSE.

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(). Вызов этого метода устанавливает “reorderable” в FALSE.

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(). Вызов этого метода устанавливает “reorderable” в FALSE.

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 модели. Переупорядочение реализуется путем установки представления значков в качестве источника и приемника перетаскивания. Поэтому перетаскивание не может использоваться в переупорядоченном представлении для других целей.

Эта функция не дает вам никакого контроля над порядком — любое переупорядочение разрешено. Если требуется больше контроля, вам, вероятно, нужно будет обработать перетаскивание вручную.

gtk_icon_view_get_reorderable ()

gboolean
gtk_icon_view_get_reorderable (GtkIconView *icon_view);

Возвращает, может ли пользователь переупорядочить список с помощью перетаскивания. См. gtk_icon_view_set_reorderable().

gtk_icon_view_set_drag-dest-item ()

void
gtk_icon_view_set_drag_dest_item (GtkIconView *icon_view,
                                  GtkTreePath *path,
                                  GtkIconViewDropPosition pos);

Устанавливает элемент, который выделен для визуального отклика.

gtk_icon_view_get_drag-dest-item ()

void
gtk_icon_view_get_drag_dest_item (GtkIconView *icon_view,
                                  GtkTreePath **path,
                                  GtkIconViewDropPosition *pos);

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

gtk_icon_view_get_dest_item_at_pos ()

gboolean
gtk_icon_view_get_dest_item_at_pos (GtkIconView *icon_view,
                                    int drag_x,
                                    int drag_y,
                                    GtkTreePath **path,
                                    GtkIconViewDropPosition *pos);

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

gtk_icon_view_create_drag_icon ()

GdkPaintable *
gtk_icon_view_create_drag_icon (GtkIconView *icon_view,
                                GtkTreePath *path);

Создаёт представление элемента в виде cairo_surface_t по координатам path. Этот образ используется для иконки перетаскивания.