The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

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

Prev

Up

Home

GTK+ Reference Manual

Next

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

GtkIconView

GtkIconView Виджет который отображает список значков в сетке

Краткое описание

#include <gtk/gtk.h>


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

GtkWidget*  gtk_icon_view_new               (void);
GtkWidget*  gtk_icon_view_new_with_model    (GtkTreeModel *model);
void        gtk_icon_view_set_model         (GtkIconView *icon_view,
                                             GtkTreeModel *model);

GtkTreeModel* gtk_icon_view_get_model       (GtkIconView *icon_view);
void        gtk_icon_view_set_text_column   (GtkIconView *icon_view,
                                             gint column);

gint        gtk_icon_view_get_text_column   (GtkIconView *icon_view);
void        gtk_icon_view_set_markup_column (GtkIconView *icon_view,
                                             gint column);

gint        gtk_icon_view_get_markup_column (GtkIconView *icon_view);
void        gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view,
                                             gint column);

gint        gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view);
GtkTreePath* gtk_icon_view_get_path_at_pos  (GtkIconView *icon_view,
                                             gint x,
                                             gint y);

gboolean    gtk_icon_view_get_item_at_pos   (GtkIconView *icon_view,
                                             gint x,
                                             gint y,
                                             GtkTreePath **path,
                                             GtkCellRenderer **cell);
void        gtk_icon_view_set_cursor        (GtkIconView *icon_view,
                                             GtkTreePath *path,
                                             GtkCellRenderer *cell,
                                             gboolean start_editing);

gboolean    gtk_icon_view_get_cursor        (GtkIconView *icon_view,
                                             GtkTreePath **path,
                                             GtkCellRenderer **cell);
void        gtk_icon_view_selected_foreach  (GtkIconView *icon_view,
                                             GtkIconViewForeachFunc func,
                                             gpointer data);
void        gtk_icon_view_set_selection_mode

                                            (GtkIconView *icon_view,
                                             GtkSelectionMode mode);
GtkSelectionMode gtk_icon_view_get_selection_mode
                                            (GtkIconView *icon_view);
void        gtk_icon_view_set_orientation   (GtkIconView *icon_view,
                                             GtkOrientation orientation);

GtkOrientation gtk_icon_view_get_orientation
                                            (GtkIconView *icon_view);
void        gtk_icon_view_set_columns       (GtkIconView *icon_view,
                                             gint columns);

gint        gtk_icon_view_get_columns       (GtkIconView *icon_view);
void        gtk_icon_view_set_item_width    (GtkIconView *icon_view,
                                             gint item_width);

gint        gtk_icon_view_get_item_width    (GtkIconView *icon_view);
void        gtk_icon_view_set_spacing       (GtkIconView *icon_view,
                                             gint spacing);

gint        gtk_icon_view_get_spacing       (GtkIconView *icon_view);
void        gtk_icon_view_set_row_spacing   (GtkIconView *icon_view,
                                             gint row_spacing);

gint        gtk_icon_view_get_row_spacing   (GtkIconView *icon_view);
void        gtk_icon_view_set_column_spacing
                                            (GtkIconView *icon_view,
                                             gint column_spacing);

gint        gtk_icon_view_get_column_spacing
                                            (GtkIconView *icon_view);
void        gtk_icon_view_set_margin        (GtkIconView *icon_view,
                                             gint margin);

gint        gtk_icon_view_get_margin        (GtkIconView *icon_view);
void        gtk_icon_view_select_path       (GtkIconView *icon_view,
                                             GtkTreePath *path);
void        gtk_icon_view_unselect_path     (GtkIconView *icon_view,
                                             GtkTreePath *path);

gboolean    gtk_icon_view_path_is_selected  (GtkIconView *icon_view,
                                             GtkTreePath *path);
GList*      gtk_icon_view_get_selected_items
                                            (GtkIconView *icon_view);
void        gtk_icon_view_select_all        (GtkIconView *icon_view);
void        gtk_icon_view_unselect_all      (GtkIconView *icon_view);
void        gtk_icon_view_item_activated    (GtkIconView *icon_view,
                                             GtkTreePath *path);
void        gtk_icon_view_scroll_to_path    (GtkIconView *icon_view,
                                             GtkTreePath *path,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);

gboolean    gtk_icon_view_get_visible_range (GtkIconView *icon_view,
                                             GtkTreePath **start_path,
                                             GtkTreePath **end_path);

enum        GtkIconViewDropPosition;
void        gtk_icon_view_enable_model_drag_source

                                            (GtkIconView *icon_view,
                                             GdkModifierType start_button_mask,
                                             const GtkTargetEntry *targets,
                                             gint n_targets,
                                             GdkDragAction actions);
void        gtk_icon_view_enable_model_drag_dest

                                            (GtkIconView *icon_view,
                                             const GtkTargetEntry *targets,
                                             gint n_targets,
                                             GdkDragAction actions);
void        gtk_icon_view_unset_model_drag_source
                                            (GtkIconView *icon_view);
void        gtk_icon_view_unset_model_drag_dest

                                            (GtkIconView *icon_view);
void        gtk_icon_view_set_reorderable   (GtkIconView *icon_view,
                                             gboolean reorderable);
gboolean    gtk_icon_view_get_reorderable   (GtkIconView *icon_view);
void        gtk_icon_view_set_drag_dest_item

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

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

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

Иерархия объектов

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer

                           +----GtkIconView

Осуществляемые интерфейсы

GtkIconView осуществляет AtkImplementorIface и GtkCellLayout.

Свойства

  "column-spacing"       gint                  : Read / Write
  "columns"              gint                  : Read / Write
  "item-width"           gint                  : Read / Write
  "margin"               gint                  : Read / Write
  "markup-column"        gint                  : Read / Write
  "model"                GtkTreeModel          : Read / Write
  "orientation"          GtkOrientation        : Read / Write
  "pixbuf-column"        gint                  : Read / Write
  "reorderable"          gboolean              : Read / Write
  "row-spacing"          gint                  : Read / Write
  "selection-mode"       GtkSelectionMode      : Read / Write
  "spacing"              gint                  : Read / Write
  "text-column"          gint                  : Read / Write

Свойства стиля

  "selection-box-alpha"  guchar                : Read
  "selection-box-color"  GdkColor              : Read

Сигналы

"activate-cursor-item"
            gboolean    user_function      (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action
"item-activated"
            void        user_function      (GtkIconView *iconview,
                                            GtkTreePath *arg1,
                                            gpointer     user_data)      : Run last
"move-cursor"
            gboolean    user_function      (GtkIconView     *iconview,
                                            GtkMovementStep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : Run last / Action
"select-all"
            void        user_function      (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action
"select-cursor-item"
            void        user_function      (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action
"selection-changed"
            void        user_function      (GtkIconView *iconview,
                                            gpointer     user_data)      : Run first
"set-scroll-adjustments"
            void        user_function      (GtkIconView   *iconview,
                                            GtkAdjustment *arg1,
                                            GtkAdjustment *arg2,
                                            gpointer       user_data)      : Run last
"toggle-cursor-item"
            void        user_function      (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action
"unselect-all"
            void        user_function      (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action

Описание

GtkIconView обеспечивает альтернативный просмотр относительно модели списка. Он отображает модель как сетку значков с ярлыками. Как и GtkTreeView, он позволяет выбирать один или несколько пунктов (зависит от режима выбора, смотрите gtk_icon_view_set_selection_mode()). В дополнение к выбору с помощью клавиш стрелок, GtkIconView поддерживает эластичное выделение, которое контролируется перетаскиванием указателя.

Детали

GtkIconView

typedef struct _GtkIconView GtkIconView;

Структура GtkIconView содержит только закрытые данные без непосредственного доступа.


GtkIconViewForeachFunc ()

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

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

icon_view :

GtkIconView

path :

GtkTreePath выделенной строки

data :

Пользовательские данные


gtk_icon_view_new ()

GtkWidget*  gtk_icon_view_new               (void);

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

Возвращает :

Вновь созданный GtkIconView виджет

Начиная с версии 2.6


gtk_icon_view_new_with_model ()

GtkWidget*  gtk_icon_view_new_with_model    (GtkTreeModel *model);

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

model :

Модель.

Возвращает :

Вновь созданный виджет GtkIconView.

Начиная с версии 2.6


gtk_icon_view_set_model ()

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

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

icon_view :

GtkIconView.

model :

Модель.

Начиная с версии 2.6


gtk_icon_view_get_model ()

GtkTreeModel* gtk_icon_view_get_model       (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

GtkTreeModel, или NULL если нет текущемй используемой модели.

Начиная с версии 2.6


gtk_icon_view_set_text_column ()

void        gtk_icon_view_set_text_column   (GtkIconView *icon_view,
                                             gint column);

Устанавливает столбец с текстом для icon_view равный column. Текст столбца должен иметь тип G_TYPE_STRING.

icon_view :

GtkIconView.

column :

Столбец в текущемй используемой модели.

Начиная с версии 2.6


gtk_icon_view_get_text_column ()

gint        gtk_icon_view_get_text_column   (GtkIconView *icon_view);

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

icon_view :

GtkIconView.

Возвращает :

Текст столбца, или -1 если он не установлен.

Начиная с версии 2.6


gtk_icon_view_set_markup_column ()

void        gtk_icon_view_set_markup_column (GtkIconView *icon_view,
                                             gint column);

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

icon_view :

GtkIconView.

column :

Столбец в текущемй используемой модели.

Начиная с версии 2.6


gtk_icon_view_get_markup_column ()

gint        gtk_icon_view_get_markup_column (GtkIconView *icon_view);

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

icon_view :

GtkIconView.

Возвращает :

Столбец разметки, или -1 если он не установлен.

Начиная с версии 2.6


gtk_icon_view_set_pixbuf_column ()

void        gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view,
                                             gint column);

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

icon_view :

GtkIconView.

column :

Столбец в текущемй используемой модели.

Начиная с версии 2.6


gtk_icon_view_get_pixbuf_column ()

gint        gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view);

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

icon_view :

GtkIconView.

Возвращает :

Столбец изображения, или -1 если не установлен.

Начиная с версии 2.6


gtk_icon_view_get_path_at_pos ()

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

Находит путь указанный точками (x, y), относительно координат виджета. Смотрите gtk_icon_view_get_item_at_pos(), если вас так же интересует ячейка в указанной позиции.

icon_view :

GtkIconView.

x :

x позиция для идентификации

y :

y позиция для идентификации

Возвращает :

GtkTreePath соответствующий значку или NULL если нет значка в этой позиции.

Начиная с версии 2.6


gtk_icon_view_get_item_at_pos ()

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

Находит путь указанный точками (x, y), относительно координат виджета. В отличии от gtk_icon_view_get_path_at_pos(), эта функция также определяет ячейку в указанной позиции. Возвращаемый путь должен освобождаться с помощью gtk_tree_path_free().

icon_view :

GtkIconView.

x :

x позиция для идентификации

y :

y позиция для идентификации

path :

Путь, или NULL

cell :

Ячейка в позиции (x, y), или NULL

Возвращает :

TRUE если элемент существует в указанной позиции

Начиная с версии 2.8


gtk_icon_view_set_cursor ()

void        gtk_icon_view_set_cursor        (GtkIconView *icon_view,
                                             GtkTreePath *path,
                                             GtkCellRenderer *cell,
                                             gboolean start_editing);

Устанавливает текущий клавиатурный фокус в позицию path, и выделяет её. Это полезно когда вам нужно привлечь внимание пользователя на специальную ячейку. Если cell не NULL, то фокус получает определенная им ячейка. Дополнительно, если start_editing это TRUE, то редактирование должно начинаться в определенной ячейки.

Эта функция часто сопровождается gtk_widget_grab_focus (icon_view) чтобы предоставить клавиатурный фокус виджету. Пожалуйста помните что редактирование возможно только когда виджет реализован.

icon_view :

GtkIconView

path :

GtkTreePath

cell :

Одна из отображаемых ячеек icon_view, или NULL

start_editing :

TRUE если редактирование должно начинаться в определенной ячейке.

Начиная с версии 2.8


gtk_icon_view_get_cursor ()

gboolean    gtk_icon_view_get_cursor        (GtkIconView *icon_view,
                                             GtkTreePath **path,
                                             GtkCellRenderer **cell);

Заполняет path и cell текущим путем и ячейкой курсора. Если текущий курсор не установлен, то *path будет NULL. Если нет ячейки с текущим фокусом, то *cell будет NULL.

Возвращаемый GtkTreePath должен освобождаться с помощью gtk_tree_path_free().

icon_view :

GtkIconView

path :

Текущий путь курсора, или NULL

cell :

Текущая ячейка в фокусе, или NULL

Возвращает :

TRUE если курсор установлен.

Начиная с версии 2.8


gtk_icon_view_selected_foreach ()

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

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

icon_view :

GtkIconView.

func :

Функция вызываемая для каждого выбранного значка.

data :

Пользовательские данные помещаемые в функцию.

Начиная с версии 2.6


gtk_icon_view_set_selection_mode ()

void        gtk_icon_view_set_selection_mode
                                            (GtkIconView *icon_view,
                                             GtkSelectionMode mode);

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

icon_view :

GtkIconView.

mode :

Режим выделения

Начиная с версии 2.6


gtk_icon_view_get_selection_mode ()

GtkSelectionMode gtk_icon_view_get_selection_mode
                                            (GtkIconView *icon_view);

Выдаёт режим выделения icon_view.

icon_view :

GtkIconView.

Возвращает :

Текущий режим выделения

Начиная с версии 2.6


gtk_icon_view_set_orientation ()

void        gtk_icon_view_set_orientation   (GtkIconView *icon_view,
                                             GtkOrientation orientation);

Устанавливает свойство ::orientation которое определяет отображаются ли ярлыки рядом со значками или под ними.

icon_view :

GtkIconView

orientation :

Относительная позиция текста и значков

Начиная с версии 2.6


gtk_icon_view_get_orientation ()

GtkOrientation gtk_icon_view_get_orientation
                                            (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Относительная позиция текста и значков

Начиная с версии 2.6


gtk_icon_view_set_columns ()

void        gtk_icon_view_set_columns       (GtkIconView *icon_view,
                                             gint columns);

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

icon_view :

GtkIconView

columns :

Количество столбцов

Начиная с версии 2.6


gtk_icon_view_get_columns ()

gint        gtk_icon_view_get_columns       (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Количество столбцов, или -1

Начиная с версии 2.6


gtk_icon_view_set_item_width ()

void        gtk_icon_view_set_item_width    (GtkIconView *icon_view,
                                             gint item_width);

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

icon_view :

GtkIconView

item_width :

Ширина каждого элемента

Начиная с версии 2.6


gtk_icon_view_get_item_width ()

gint        gtk_icon_view_get_item_width    (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Ширина единственного элемента, или -1

Начиная с версии 2.6


gtk_icon_view_set_spacing ()

void        gtk_icon_view_set_spacing       (GtkIconView *icon_view,
                                             gint spacing);

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

icon_view :

GtkIconView

spacing :

интервал

Начиная с версии 2.6


gtk_icon_view_get_spacing ()

gint        gtk_icon_view_get_spacing       (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Интервал между ячейками

Начиная с версии 2.6


gtk_icon_view_set_row_spacing ()

void        gtk_icon_view_set_row_spacing   (GtkIconView *icon_view,
                                             gint row_spacing);

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

icon_view :

GtkIconView

row_spacing :

Строковый интервал

Начиная с версии 2.6


gtk_icon_view_get_row_spacing ()

gint        gtk_icon_view_get_row_spacing   (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Интервал между строками

Начиная с версии 2.6


gtk_icon_view_set_column_spacing ()

void        gtk_icon_view_set_column_spacing
                                            (GtkIconView *icon_view,
                                             gint column_spacing);

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

icon_view :

GtkIconView

column_spacing :

интервал между столбцами

Начиная с версии 2.6


gtk_icon_view_get_column_spacing ()

gint        gtk_icon_view_get_column_spacing
                                            (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Интервал между столбцами

Начиная с версии 2.6


gtk_icon_view_set_margin ()

void        gtk_icon_view_set_margin        (GtkIconView *icon_view,
                                             gint margin);

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

icon_view :

GtkIconView

margin :

граница

Начиная с версии 2.6


gtk_icon_view_get_margin ()

gint        gtk_icon_view_get_margin        (GtkIconView *icon_view);

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

icon_view :

GtkIconView

Возвращает :

Интервал границ

Начиная с версии 2.6


gtk_icon_view_select_path ()

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

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

icon_view :

GtkIconView.

path :

GtkTreePath для выбора.

Начиная с версии 2.6


gtk_icon_view_unselect_path ()

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

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

icon_view :

GtkIconView.

path :

GtkTreePath для снятия выделения.

Начиная с версии 2.6


gtk_icon_view_path_is_selected ()

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

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

icon_view :

GtkIconView.

path :

GtkTreePath для контроля выбора.

Возвращает :

TRUE если path выбран.

Начиная с версии 2.6


gtk_icon_view_get_selected_items ()

GList*      gtk_icon_view_get_selected_items
                                            (GtkIconView *icon_view);

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

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

g_list_foreach (list, gtk_tree_path_free, NULL);
g_list_free (list);

icon_view :

GtkIconView.

Возвращает :

GList содержащий GtkTreePath для каждой выделенной строки.

Начиная с версии 2.6


gtk_icon_view_select_all ()

void        gtk_icon_view_select_all        (GtkIconView *icon_view);

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

icon_view :

GtkIconView.

Начиная с версии 2.6


gtk_icon_view_unselect_all ()

void        gtk_icon_view_unselect_all      (GtkIconView *icon_view);

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

icon_view :

GtkIconView.

Начиная с версии 2.6


gtk_icon_view_item_activated ()

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

Активизирует элементы определенные параметром path.

icon_view :

GtkIconView

path :

GtkTreePath для активизации

Начиная с версии 2.6


gtk_icon_view_scroll_to_path ()

void        gtk_icon_view_scroll_to_path    (GtkIconView *icon_view,
                                             GtkTreePath *path,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);

Перемещает выравнивание icon_view в позицию определённую параметром path. row_align определяет где размещается строка, а col_align определяет где размещается column. Оба параметра располагаются в пределах между 0.0 и 1.0. 0.0 означает левое-верхнее выравнивание, 1.0 означает правое нижнее выравнивание, 0.5 означает центр.

Если use_align равен FALSE, то аргументы выравнивания игнорируются, а дерево выполняет минимум работы для прокручивания элементов на экране. Это значит что элементы будут прокручены до самого ближнего края от текущемй позиции. Если элементы в текущий момент видимы на экране, ничего не происходит.

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

icon_view :

GtkIconView.

path :

Путь для перемещения элементов.

use_align :

Используются ли аргументы выравнивания, или FALSE.

row_align :

Вертикальное выравнивание элементов определённых параметром path.

col_align :

Горизонтальное выравнивание элементов определённых параметром path.

Начиная с версии 2.8


gtk_icon_view_get_visible_range ()

gboolean    gtk_icon_view_get_visible_range (GtkIconView *icon_view,
                                             GtkTreePath **start_path,
                                             GtkTreePath **end_path);

Устанавливает start_path и end_path для первого и последнего видимого пути. Помните что между ними могут быть невидимые пути.

Пути должны освобождаться с помощью gtk_tree_path_free() после использования.

icon_view :

GtkIconView

start_path :

Начало диапазона, или NULL

end_path :

Конец диапазона, или NULL

Возвращает :

TRUE, если доступные пути размещены в параметры start_path и end_path

Начиная с версии 2.8


enum GtkIconViewDropPosition

typedef enum
{
  GTK_ICON_VIEW_NO_DROP,
  GTK_ICON_VIEW_DROP_INTO,
  GTK_ICON_VIEW_DROP_LEFT,
  GTK_ICON_VIEW_DROP_RIGHT,
  GTK_ICON_VIEW_DROP_ABOVE,
  GTK_ICON_VIEW_DROP_BELOW
} GtkIconViewDropPosition;

Перечисление для определения куда направляется перемещаемый элемент.

GTK_ICON_VIEW_NO_DROP

Перетаскивание не возможно

GTK_ICON_VIEW_DROP_INTO

Перетаскиваемый элемент замещает элемент

GTK_ICON_VIEW_DROP_LEFT

Перетаскиваемый элемент вставляется слева

GTK_ICON_VIEW_DROP_RIGHT

Перетаскиваемый элемент вставляется справа

GTK_ICON_VIEW_DROP_ABOVE

Перетаскиваемый элемент вставляется выше

GTK_ICON_VIEW_DROP_BELOW

Перетаскиваемый элемент вставляется ниже


gtk_icon_view_enable_model_drag_source ()

void        gtk_icon_view_enable_model_drag_source
                                            (GtkIconView *icon_view,
                                             GdkModifierType start_button_mask,
                                             const GtkTargetEntry *targets,
                                             gint n_targets,
                                             GdkDragAction actions);

Интерпретирует icon_view в источник перетаскивания для автоматического DND.

icon_view :

GtkIconTreeView

start_button_mask :

Маска допустимых кнопок для начала перетаскивания

targets :

Таблица целей которые поддерживают перетаскивание

n_targets :

Количество элементов в targets

actions :

Битовая маска возможных действий для перетаскивания из этого виджета

Начиная с версии 2.8


gtk_icon_view_enable_model_drag_dest ()

void        gtk_icon_view_enable_model_drag_dest
                                            (GtkIconView *icon_view,
                                             const GtkTargetEntry *targets,
                                             gint n_targets,
                                             GdkDragAction actions);

Интерпретирует icon_view в адресат перетаскивания для автоматического DND.

icon_view :

GtkIconView

targets :

Таблица целей которые поддерживают перетаскивание

n_targets :

Количество элементов в targets

actions :

Битовая маска возможных действий для перетаскивания из этого виджета

Начиная с версии 2.8


gtk_icon_view_unset_model_drag_source ()

void        gtk_icon_view_unset_model_drag_source
                                            (GtkIconView *icon_view);

Отменяет действие функции gtk_icon_view_enable_model_drag_source().

icon_view :

GtkIconView

Начиная с версии 2.8


gtk_icon_view_unset_model_drag_dest ()

void        gtk_icon_view_unset_model_drag_dest
                                            (GtkIconView *icon_view);

Отменяет действие функции gtk_icon_view_enable_model_drag_dest().

icon_view :

GtkIconView

Начиная с версии 2.8


gtk_icon_view_set_reorderable ()

void        gtk_icon_view_set_reorderable   (GtkIconView *icon_view,
                                             gboolean reorderable);

Это удобная функция для переупорядочивания моделей поддерживающих GtkTreeDragSourceIface и GtkTreeDragDestIface. И GtkTreeStore и GtkListStore поддерживают их. Если reorderable равен TRUE, то пользователь может пере-упорядочивать модель перетаскиванием строк. Разработчик может контролировать эти изменения модели подключив сигналы row_inserted и row_deleted.

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

icon_view :

GtkIconView.

reorderable :

TRUE, если список элементов может быть переупорядочен.

Начиная с версии 2.8


gtk_icon_view_get_reorderable ()

gboolean    gtk_icon_view_get_reorderable   (GtkIconView *icon_view);

Определяет может ли пользователь пере-упорядочивать список через drag-and-drop. Смотрите gtk_icon_view_set_reorderable().

icon_view :

GtkIconView

Возвращает :

TRUE если список может быть переупорядочен.

Начиная с версии 2.8


gtk_icon_view_set_drag_dest_item ()

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

Устанавливает элемент который подсвечивается для обратной связи.

icon_view :

GtkIconView

path :

Путь элемента для подсвечивания, или NULL.

pos :

Определяет позицию относительно элемента

Начиная с версии 2.8


gtk_icon_view_get_drag_dest_item ()

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

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

icon_view :

GtkIconView

path :

Путь подсвечиваемого элемента, или NULL.

pos :

Позиция перемещения, или NULL

Начиная с версии 2.8


gtk_icon_view_get_dest_item_at_pos ()

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

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

icon_view :

GtkIconView

drag_x :

Позиция для определения элемента адресата

drag_y :

Позиция для определения элемента адресата

path :

Путь элемента, или NULL.

pos :

Позиция перемещения, или NULL

Возвращает :

Есть ли элемент в данной позиции.

Начиная с версии 2.8


gtk_icon_view_create_drag_icon ()

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

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

icon_view :

GtkIconView

path :

GtkTreePath в icon_view

Возвращает :

Вновь созданный значок перетаскивания.

Начиная с версии 2.8

Детали свойств

Свойство "column-spacing"

  "column-spacing"       gint                  : Read / Write

Интервал между столбцами сетки.

Допустимые значения: >= 0

Значение по умолчанию : 6


Свойство "columns"

  "columns"              gint                  : Read / Write

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

Допустимые значения: >= -1

Значение по умолчанию : -1

Начиная с версии 2.6


Свойство "item-width"

  "item-width"           gint                  : Read / Write

Ширина каждого элемента.

Допустимые значения: >= -1

Значение по умолчанию : -1


Свойство "margin"

  "margin"               gint                  : Read / Write

Интервал между границами просмотра значков.

Допустимые значения: >= 0

Значение по умолчанию : 6


Свойство "markup-column"

  "markup-column"        gint                  : Read / Write

Свойство ::markup-column содержит количество столбцов модели содержащих информацию разметки для отображения. Столбец разметки должен иметь тип G_TYPE_STRING. Если это свойство и свойство :text-column установлены оба в количество столбцов, оно отменяет текстовый столбец. Если оба свойства установлены в -1, текст не отображается.

Допустимые значения: >= -1

Значение по умолчанию : -1

Начиная с версии 2.6


Свойство "model"

  "model"                GtkTreeModel          : Read / Write

Модель для просмотра значков.


Свойство "orientation"

  "orientation"          GtkOrientation        : Read / Write

Как текст и значок располагаются относительно друг друга.

Значение по умолчанию : GTK_ORIENTATION_VERTICAL


Свойство "pixbuf-column"

  "pixbuf-column"        gint                  : Read / Write

Свойство ::pixbuf-column содержит количество столбцов модели содержащих изображения для отображения. Столбец изображения должен иметь тип GDK_TYPE_PIXBUF. Установка этого свойства в -1 отключает отображение изображений.

Допустимые значения: >= -1

Значение по умолчанию : -1

Начиная с версии 2.6


Свойство "reorderable"

  "reorderable"          gboolean              : Read / Write

Свойство определяющее возможность переупорядочивания элементов с помощью DND.

Значение по умолчанию : FALSE

Начиная с версии 2.8


Свойство "row-spacing"

  "row-spacing"          gint                  : Read / Write

Интервал между строками сетки.

Допустимые значения: >= 0

Значение по умолчанию : 6


Свойство "selection-mode"

  "selection-mode"       GtkSelectionMode      : Read / Write

Свойство ::selection-mode определяет режим выделения просмотра значков. Если режим GTK_SELECTION_MULTIPLE, эластичное выделение включено, для других режимов возможно только клавиатурное выделение.

Значение по умолчанию : GTK_SELECTION_SINGLE

Начиная с версии 2.6


Свойство "spacing"

  "spacing"              gint                  : Read / Write

Интервал между ячейками элементов.

Допустимые значения: >= 0

Значение по умолчанию : 0


Свойство "text-column"

  "text-column"          gint                  : Read / Write

Свойство ::text-column содержит количество столбцов модели содержащих текст для отображения. Текстовый столбец должен иметь тип G_TYPE_STRING. Если это свойство и свойство :markup-column оба установлены в -1, текст не отображается.

Допустимые значения: >= -1

Значение по умолчанию : -1

Начиная с версии 2.6

Детали свойств стиля

Свойство стиля "selection-box-alpha"

  "selection-box-alpha"  guchar                : Read

Затенение контейнера выделения.

Значение по умолчанию : 64


Свойство стиля "selection-box-color"

  "selection-box-color"  GdkColor              : Read

Цвет контейнера выделения.

Детали сигналов

Сигнал "activate-cursor-item"

gboolean    user_function                  (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action

iconview :

объект получающий сигнал.

user_data :

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

Возвращает :


Сигнал "item-activated"

void        user_function                  (GtkIconView *iconview,
                                            GtkTreePath *arg1,
                                            gpointer     user_data)      : Run last

iconview :

объект получающий сигнал.

arg1 :

user_data :

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


Сигнал "move-cursor"

gboolean    user_function                  (GtkIconView     *iconview,
                                            GtkMovementStep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : Run last / Action

iconview :

объект получающий сигнал.

arg1 :

arg2 :

user_data :

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

Возвращает :


Сигнал "select-all"

void        user_function                  (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action

iconview :

объект получающий сигнал.

user_data :

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


Сигнал "select-cursor-item"

void        user_function                  (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action

iconview :

объект получающий сигнал.

user_data :

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


Сигнал "selection-changed"

void        user_function                  (GtkIconView *iconview,
                                            gpointer     user_data)      : Run first

iconview :

объект получающий сигнал.

user_data :

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


Сигнал "set-scroll-adjustments"

void        user_function                  (GtkIconView   *iconview,
                                            GtkAdjustment *arg1,
                                            GtkAdjustment *arg2,
                                            gpointer       user_data)      : Run last

iconview :

объект получающий сигнал.

arg1 :

arg2 :

user_data :

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


Сигнал "toggle-cursor-item"

void        user_function                  (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action

iconview :

объект получающий сигнал.

user_data :

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


Сигнал "unselect-all"

void        user_function                  (GtkIconView *iconview,
                                            gpointer     user_data)      : Run last / Action

iconview :

объект получающий сигнал.

user_data :

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






Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру