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

Устанавливает столбец с pixbuf для 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().

С: 2.8

gtk_icon_view_selected_foreach ()

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

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

С: 2.6

gtk_icon_view_set_selection_mode ()

void
gtk_icon_view_set_selection_mode (GtkIconView *icon_view,
                                  GtkSelectionMode mode);

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

С: 2.6

gtk_icon_view_get_selection_mode ()

GtkSelectionMode
gtk_icon_view_get_selection_mode (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_item_orientation ()

void
gtk_icon_view_set_item_orientation (GtkIconView *icon_view,
                                    GtkOrientation orientation);

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

С: 2.6

gtk_icon_view_get_item_orientation ()

GtkOrientation
gtk_icon_view_get_item_orientation (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_columns ()

void
gtk_icon_view_set_columns (GtkIconView *icon_view,
                           gint columns);

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

С: 2.6

gtk_icon_view_get_columns ()

gint
gtk_icon_view_get_columns (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_item_width ()

void
gtk_icon_view_set_item_width (GtkIconView *icon_view,
                              gint item_width);

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

С: 2.6

gtk_icon_view_get_item_width ()

gint
gtk_icon_view_get_item_width (GtkIconView *icon_view);

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

С: 2.6

gtk_icon_view_set_spacing ()

void
gtk_icon_view_set_spacing (GtkIconView *icon_view,
                           gint spacing);

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

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

Возвращаемое значение указывает, есть ли элемент представления значка в заданных координатах (TRUE) или нет (FALSE) для подсказок при наведении курсора мыши. Для подсказок при нажатии клавиш возвращаемый элемент — это элемент курсора. При TRUE, любое из model, path и iter, которые были предоставлены, будет установлено на указание этой строки и соответствующей модели. x и y всегда будут преобразованы, чтобы быть относительными к icon_view ’s 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(), поэтому &, < и т. д. должны быть экранированы в тексте.

С: 2.12

gtk_icon_view_get_tooltip_column ()

gint
gtk_icon_view_get_tooltip_column (GtkIconView *icon_view);

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

С: 2.12

gtk_icon_view_get_item_row ()

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

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

С: 2.22

gtk_icon_view_get_item_column ()

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

Получает столбец, в котором отображается элемент path. Номера столбцов начинаются с 0.

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

С версии: 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.

С версии: 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.

С версии: 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.

С версии: 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