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

С: 2.6

gtk_icon_view_new_with_area ()

GtkWidget *
gtk_icon_view_new_with_area (GtkCellArea *area);

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

С: 3.0

gtk_icon_view_new_with_model ()

GtkWidget *
gtk_icon_view_new_with_model (GtkTreeModel *model);

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

С: 2.6

gtk_icon_view_set_model ()

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

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

С: 2.6

gtk_icon_view_get_model ()

GtkTreeModel *
gtk_icon_view_get_model (GtkIconView *icon_view);

Возвращает модель, на основе которой построен виджет GtkIconView. Возвращает 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.

С: 2.6

gtk_icon_view_get_text_column ()

gint
gtk_icon_view_get_text_column (GtkIconView *icon_view);

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

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

С: 2.6

gtk_icon_view_get_markup_column ()

gint
gtk_icon_view_get_markup_column (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_pixbuf_column ()

void
gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view,
                                 gint column);

Устанавливает столбец с pixbufs для icon_view в column . Столбец pixbuf должен иметь тип GDK_TYPE_PIXBUF

С: 2.6

gtk_icon_view_get_pixbuf_column ()

gint
gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view);

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

С: 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 ), относительно координат bin_window. См. gtk_icon_view_get_item_at_pos(), если вы также заинтересованы в ячейке в указанной позиции. См. gtk_icon_view_convert_widget_to_bin_window_coords() для преобразования координат виджета в координаты bin_window.

С: 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 ), относительно координат bin_window. В отличие от gtk_icon_view_get_path_at_pos(), эта функция также получает ячейку в указанной позиции. Возвращаемый путь следует освободить с помощью gtk_tree_path_free(). См. gtk_icon_view_convert_widget_to_bin_window_coords() для преобразования координат виджета в координаты bin_window.

С: 2.8

gtk_icon_view_convert_widget_to_bin-window-coords ()

void
gtk_icon_view_convert_widget_to_bin_window_coords
                               (GtkIconView *icon_view,
                                gint wx,
                                gint wy,
                                gint *bx,
                                gint *by);

Преобразует координаты виджета в координаты bin_window, как ожидается, например, функцией gtk_icon_view_get_path_at_pos().

С: 2.12

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

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

C момента: 2.8

gtk_icon_view_selected_foreach ()

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

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

C момента: 2.6

gtk_icon_view_set_selection_mode ()

void
gtk_icon_view_set_selection_mode (GtkIconView *icon_view,
                                  GtkSelectionMode mode);

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

C момента: 2.6

gtk_icon_view_get_selection_mode ()

GtkSelectionMode
gtk_icon_view_get_selection_mode (GtkIconView *icon_view);

Возвращает режим выбора icon_view .

C момента: 2.6

gtk_icon_view_set_item_orientation ()

void
gtk_icon_view_set_item_orientation (GtkIconView *icon_view,
                                    GtkOrientation orientation);

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

C момента: 2.6

gtk_icon_view_get_item_orientation ()

GtkOrientation
gtk_icon_view_get_item_orientation (GtkIconView *icon_view);

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

C момента: 2.6

gtk_icon_view_set_columns ()

void
gtk_icon_view_set_columns (GtkIconView *icon_view,
                           gint columns);

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

C момента: 2.6

gtk_icon_view_get_columns ()

gint
gtk_icon_view_get_columns (GtkIconView *icon_view);

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

C момента: 2.6

gtk_icon_view_set_item_width ()

void
gtk_icon_view_set_item_width (GtkIconView *icon_view,
                              gint item_width);

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

C момента: 2.6

gtk_icon_view_get_item_width ()

gint
gtk_icon_view_get_item_width (GtkIconView *icon_view);

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

C момента: 2.6

gtk_icon_view_set_spacing ()

void
gtk_icon_view_set_spacing (GtkIconView *icon_view,
                           gint spacing);

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

C момента: 2.6

gtk_icon_view_get_spacing ()

gint
gtk_icon_view_get_spacing (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_row_spacing ()

void
gtk_icon_view_set_row_spacing (GtkIconView *icon_view,
                               gint row_spacing);

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

С: 2.6

gtk_icon_view_get_row_spacing ()

gint
gtk_icon_view_get_row_spacing (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_column_spacing ()

void
gtk_icon_view_set_column_spacing (GtkIconView *icon_view,
                                  gint column_spacing);

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

С: 2.6

gtk_icon_view_get_column_spacing ()

gint
gtk_icon_view_get_column_spacing (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_margin ()

void
gtk_icon_view_set_margin (GtkIconView *icon_view,
                          gint margin);

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

С: 2.6

gtk_icon_view_get_margin ()

gint
gtk_icon_view_get_margin (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_item_padding ()

void
gtk_icon_view_set_item_padding (GtkIconView *icon_view,
                                gint item_padding);

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

С: 2.18

gtk_icon_view_get_item_padding ()

gint
gtk_icon_view_get_item_padding (GtkIconView *icon_view);

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

С: 2.18

gtk_icon_view_set_activate_on_single_click ()

void
gtk_icon_view_set_activate_on_single_click
                               (GtkIconView *icon_view,
                                gboolean single);

Приводит к тому, что сигнал “item-activated” будет генерироваться при одном щелчке вместо двойного.

С: 3.8

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

С: 3.8

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 реализован.

С: 3.6

gtk_icon_view_select_path ()

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

Выбирает строку по адресу path .

С версии: 2.6

gtk_icon_view_unselect_path ()

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

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

С версии: 2.6

gtk_icon_view_path_is_selected ()

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

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

С версии: 2.6

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]

С версии: 2.6

gtk_icon_view_select_all ()

void
gtk_icon_view_select_all (GtkIconView *icon_view);

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

С версии: 2.6

gtk_icon_view_unselect_all ()

void
gtk_icon_view_unselect_all (GtkIconView *icon_view);

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

С версии: 2.6

gtk_icon_view_item_activated ()

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

Активирует элемент, указанный path .

С версии: 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 реализована, центрированный путь будет изменён для отражения этого изменения.

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

С: 2.8

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

С: 2.12

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() для более простого варианта.

С: 2.12

gtk_icon_view_get_tooltip_context ()

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

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

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

С: 2.12

gtk_icon_view_set_tooltip_column ()

void
gtk_icon_view_set_tooltip_column (GtkIconView *icon_view,
                                  gint column);

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

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

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

Since: 2.12

gtk_icon_view_get_tooltip_column ()

gint
gtk_icon_view_get_tooltip_column (GtkIconView *icon_view);

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

Since: 2.12

gtk_icon_view_get_item_row ()

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

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

Since: 2.22

gtk_icon_view_get_item_column ()

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

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

Since: 2.22

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

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

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

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

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

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

С: 2.8

gtk_icon_view_get_reorderable ()

gboolean
gtk_icon_view_get_reorderable (GtkIconView *icon_view);

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

С: 2.8

gtk_icon_view_set_drag_dest_item ()

void
gtk_icon_view_set_drag_dest_item (GtkIconView *icon_view,
                                  GtkTreePath *path,
                                  GtkIconViewDropPosition 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);

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

С: 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);

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

С: 2.8

gtk_icon_view_create_drag-icon ()

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

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

С: 2.8