Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkTreeViewColumn

GtkTreeViewColumn Видимый столбец в виджете GtkTreeView

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

#include <gtk/gtk.h> enum GtkTreeViewColumnSizing; void (*GtkTreeCellDataFunc) (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, GtkTreeModel *tree_model, GtkTreeIter *iter, gpointer data); GtkTreeViewColumn; GtkTreeViewColumn* gtk_tree_view_column_new (void); GtkTreeViewColumn* gtk_tree_view_column_new_with_attributes (const gchar *title, GtkCellRenderer *cell, ...); void gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand); void gtk_tree_view_column_pack_end (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand); void gtk_tree_view_column_clear (GtkTreeViewColumn *tree_column); GList* gtk_tree_view_column_get_cell_renderers (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_add_attribute (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, const gchar *attribute, gint column); void gtk_tree_view_column_set_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, ...); void gtk_tree_view_column_set_cell_data_func (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, GtkTreeCellDataFunc func, gpointer func_data, GtkDestroyNotify destroy); void gtk_tree_view_column_clear_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer); void gtk_tree_view_column_set_spacing (GtkTreeViewColumn *tree_column, gint spacing); gint gtk_tree_view_column_get_spacing (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_visible (GtkTreeViewColumn *tree_column, gboolean visible); gboolean gtk_tree_view_column_get_visible (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_resizable (GtkTreeViewColumn *tree_column, gboolean resizable); gboolean gtk_tree_view_column_get_resizable (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sizing (GtkTreeViewColumn *tree_column, GtkTreeViewColumnSizing type); GtkTreeViewColumnSizing gtk_tree_view_column_get_sizing (GtkTreeViewColumn *tree_column); gint gtk_tree_view_column_get_width (GtkTreeViewColumn *tree_column); gint gtk_tree_view_column_get_fixed_width (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_fixed_width (GtkTreeViewColumn *tree_column, gint fixed_width); void gtk_tree_view_column_set_min_width (GtkTreeViewColumn *tree_column, gint min_width); gint gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_max_width (GtkTreeViewColumn *tree_column, gint max_width); gint gtk_tree_view_column_get_max_width (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_clicked (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_title (GtkTreeViewColumn *tree_column, const gchar *title); const gchar* gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column, gboolean expand); gboolean gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_clickable (GtkTreeViewColumn *tree_column, gboolean clickable); gboolean gtk_tree_view_column_get_clickable (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_widget (GtkTreeViewColumn *tree_column, GtkWidget *widget); GtkWidget* gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_alignment (GtkTreeViewColumn *tree_column, gfloat xalign); gfloat gtk_tree_view_column_get_alignment (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_reorderable (GtkTreeViewColumn *tree_column, gboolean reorderable); gboolean gtk_tree_view_column_get_reorderable (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sort_column_id (GtkTreeViewColumn *tree_column, gint sort_column_id); gint gtk_tree_view_column_get_sort_column_id (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sort_indicator (GtkTreeViewColumn *tree_column, gboolean setting); gboolean gtk_tree_view_column_get_sort_indicator (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sort_order (GtkTreeViewColumn *tree_column, GtkSortType order); GtkSortType gtk_tree_view_column_get_sort_order (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_cell_set_cell_data (GtkTreeViewColumn *tree_column, GtkTreeModel *tree_model, GtkTreeIter *iter, gboolean is_expander, gboolean is_expanded); void gtk_tree_view_column_cell_get_size (GtkTreeViewColumn *tree_column, GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height); gboolean gtk_tree_view_column_cell_get_position (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, gint *start_pos, gint *width); gboolean gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell); void gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkTreeViewColumn

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

GtkTreeViewColumn осуществляет GtkCellLayout.

Свойства

"alignment" gfloat : Read / Write "clickable" gboolean : Read / Write "expand" gboolean : Read / Write "fixed-width" gint : Read / Write "max-width" gint : Read / Write "min-width" gint : Read / Write "reorderable" gboolean : Read / Write "resizable" gboolean : Read / Write "sizing" GtkTreeViewColumnSizing : Read / Write "sort-indicator" gboolean : Read / Write "sort-order" GtkSortType : Read / Write "spacing" gint : Read / Write "title" gchararray : Read / Write "visible" gboolean : Read / Write "widget" GtkWidget : Read / Write "width" gint : Read

Сигналы

"clicked" void user_function (GtkTreeViewColumn *treeviewcolumn, gpointer user_data) : Run last

Описание

GtkTreeViewColumn объект представляет видимый столбец в GtkTreeView виджете. Это позволяет устанавливать свойства заголовка столбца и функции для ячеек представления, которые определяют как отображаются данные в столбце.

Пожалуйста обратитесь к tree widget conceptual overview который кратко описывает все объекты и типы данных связанные с виджетом дерева просмотра и как они взаимодействуют.

Детали

enum GtkTreeViewColumnSizing

typedef enum { GTK_TREE_VIEW_COLUMN_GROW_ONLY, GTK_TREE_VIEW_COLUMN_AUTOSIZE, GTK_TREE_VIEW_COLUMN_FIXED } GtkTreeViewColumnSizing;

Метод установки размера используемого столбца для определения его ширины. Пожалуйста отметьте что GTK_TREE_VIEW_COLUMN_AUTOSIZE является не эффективным для большинства полей просмотров и может заставить столбцы казаться нестабильными.

GTK_TREE_VIEW_COLUMN_GROW_ONLY

Столбцы становятся только больше реагируя на изменения в модели

GTK_TREE_VIEW_COLUMN_AUTOSIZE

Столбцы принимают оптимальный размер всегда при изменении модели.

GTK_TREE_VIEW_COLUMN_FIXED

Столбцы имеют фиксированную ширину в пикселах.


GtkTreeCellDataFunc ()

void (*GtkTreeCellDataFunc) (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, GtkTreeModel *tree_model, GtkTreeIter *iter, gpointer data);

Функция устанавливает свойства ячейки, вместо того, чтобы просто использовать прямое соответствие между ячейкой и моделью. Это полезно для настройки ячеек представления. Например, функция может получить целочисленное из tree_model, и представить его для параметра "text" принадлежащего "cell", преобразовав его в прописной эквивалент. Это устанавливается вызовом gtk_tree_view_column_set_cell_data_func()

tree_column :

GtkTreeColumn

cell :

GtkCellRenderer который представляется tree_column

tree_model :

Представляемый GtkTreeModel

iter :

Представляющий GtkTreeIter текущемй строки

data :

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


GtkTreeViewColumn

typedef struct _GtkTreeViewColumn GtkTreeViewColumn;

gtk_tree_view_column_new ()

GtkTreeViewColumn* gtk_tree_view_column_new (void);

Создаёт новый GtkTreeViewColumn.

Возвращает :

Вновь созданный GtkTreeViewColumn.


gtk_tree_view_column_new_with_attributes ()

GtkTreeViewColumn* gtk_tree_view_column_new_with_attributes (const gchar *title, GtkCellRenderer *cell, ...);

Создаёт новый GtkTreeViewColumn с множеством значений по умолчанию. Это эквивалентно вызову gtk_tree_view_column_set_title(), gtk_tree_view_column_pack_start() и gtk_tree_view_column_set_attributes() на вновь созданном GtkTreeViewColumn.

Вот простой пример:

enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS }; ... { GtkTreeViewColumn *column; GtkCellRenderer *renderer = gtk_cell_renderer_text_new (); column = gtk_tree_view_column_new_with_attributes ("Title", renderer, "text", TEXT_COLUMN, "foreground", COLOR_COLUMN, NULL); }

title :

Устанавливаемый заголовок.

cell :

GtkCellRenderer.

... :

NULL-завершенный список параметров.

Возвращает :

Вновь созданный GtkTreeViewColumn.


gtk_tree_view_column_pack_start ()

void gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand);

Упаковывает cell в начало столбца. Если expand равно FALSE, то когда cell не занимает больше свободного пространства чем нужно. Любое свободное пространство распределяется между ячейками для которых expand равен TRUE.

tree_column :

GtkTreeViewColumn.

cell :

GtkCellRenderer.

expand :

TRUE если cell нужно дать дополнительное пространство распределённое для tree_column.


gtk_tree_view_column_pack_end ()

void gtk_tree_view_column_pack_end (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand);

Добавляет cell в конец столбца. Если expand равно FALSE, то когда cell не занимает больше пространства чем необходимо. Любое свободное пространство распределяется между ячейками для которых expand равен TRUE.

tree_column :

GtkTreeViewColumn.

cell :

GtkCellRenderer.

expand :

TRUE если cell нужно дать дополнительное пространство распределённое для tree_column.


gtk_tree_view_column_clear ()

void        gtk_tree_view_column_clear      (GtkTreeViewColumn *tree_column);

Очищает все отображение в tree_column.

tree_column :

GtkTreeViewColumn


gtk_tree_view_column_get_cell_renderers ()

GList* gtk_tree_view_column_get_cell_renderers (GtkTreeViewColumn *tree_column);

Возвращает вновь созданный GList всех ячеек отображения в столбце, в неопределенном порядке. Список должен освобождаться с помощью g_list_free().

tree_column :

GtkTreeViewColumn

Возвращает :

Список GtkCellRenderers


gtk_tree_view_column_add_attribute ()

void gtk_tree_view_column_add_attribute (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, const gchar *attribute, gint column);

Добавляет параметры отображения в список для tree_column. Столбец column это получаемое значение из модели, а attribute это параметры cell_renderer установленного из значения. Так например, если столбец 2 модели содержит строки, вы должны получить параметр "text" GtkCellRendererText из столбца 2.

tree_column :

GtkTreeViewColumn.

cell_renderer :

GtkCellRenderer для установки параметров

attribute :

Параметр отображения

column :

Позиция столбца в модели из которого получается параметр.


gtk_tree_view_column_set_attributes ()

void gtk_tree_view_column_set_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, ...);

Устанавливает параметр в список параметров tree_column. Параметры должны быть в порядке параметр/столбец, как в gtk_tree_view_column_add_attribute(). Все существующие параметры удаляются, и устанавливаются новые параметры.

tree_column :

GtkTreeViewColumn.

cell_renderer :

GtkCellRenderer куда устанавливаются параметры

... :

NULL-завершенный список параметров.


gtk_tree_view_column_set_cell_data_func ()

void gtk_tree_view_column_set_cell_data_func (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, GtkTreeCellDataFunc func, gpointer func_data, GtkDestroyNotify destroy);

Устанавливает GtkTreeViewColumnFunc используемую для столбца. Эта функция используется вместо стандартных параметров отображения для установок значения столбца, и должна установить соответствующее значение tree_column's ячейки отображения. func может быть NULL для удаления старых параметров.

tree_column :

GtkTreeViewColumn

cell_renderer :

GtkCellRenderer

func :

используемая GtkTreeViewColumnFunc.

func_data :

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

destroy :

Разрушающее уведомление для func_data


gtk_tree_view_column_clear_attributes ()

void gtk_tree_view_column_clear_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer);

Очищает все параметры предварительно установленные с помощью gtk_tree_view_column_set_attributes().

tree_column :

GtkTreeViewColumn

cell_renderer :

GtkCellRenderer для очищения параметров отображения.


gtk_tree_view_column_set_spacing ()

void gtk_tree_view_column_set_spacing (GtkTreeViewColumn *tree_column, gint spacing);

Устанавливает поле интервала tree_column, которое является числом пикселей помещаемых между ячейками представления.

tree_column :

GtkTreeViewColumn.

spacing :

Расстояние между ячейками в пикселах.


gtk_tree_view_column_get_spacing ()

gint gtk_tree_view_column_get_spacing (GtkTreeViewColumn *tree_column);

Возвращает интервал tree_column.

tree_column :

GtkTreeViewColumn.

Возвращает :

интервал tree_column.


gtk_tree_view_column_set_visible ()

void gtk_tree_view_column_set_visible (GtkTreeViewColumn *tree_column, gboolean visible);

Устанавливает видимость tree_column.

tree_column :

GtkTreeViewColumn.

visible :

TRUE если tree_column видим.


gtk_tree_view_column_get_visible ()

gboolean gtk_tree_view_column_get_visible (GtkTreeViewColumn *tree_column);

Возвращает TRUE если tree_column видим.

tree_column :

GtkTreeViewColumn.

Возвращает :

Видим ли столбец или нет. Если он видим, то когда дерево показывает его.


gtk_tree_view_column_set_resizable ()

void gtk_tree_view_column_set_resizable (GtkTreeViewColumn *tree_column, gboolean resizable);

Если resizable равно TRUE, то когда пользователь может явно менять размер столбца захватывая край кнопки столбца. Если изменяемость размера TRUE и режим размера столбца GTK_TREE_VIEW_COLUMN_AUTOSIZE, то когда режим размера изменяется в GTK_TREE_VIEW_COLUMN_GROW_ONLY.

tree_column :

GtkTreeViewColumn

resizable :

TRUE, если столбец может изменять размер


gtk_tree_view_column_get_resizable ()

gboolean gtk_tree_view_column_get_resizable (GtkTreeViewColumn *tree_column);

Возвращает TRUE если размер tree_column может быть изменен конечным пользователем.

tree_column :

GtkTreeViewColumn

Возвращает :

TRUE, если размер tree_column может изменяться.


gtk_tree_view_column_set_sizing ()

void gtk_tree_view_column_set_sizing (GtkTreeViewColumn *tree_column, GtkTreeViewColumnSizing type);

Устанавливает поведение роста tree_column в type.

tree_column :

GtkTreeViewColumn.

type :

GtkTreeViewColumnSizing.


gtk_tree_view_column_get_sizing ()

GtkTreeViewColumnSizing gtk_tree_view_column_get_sizing (GtkTreeViewColumn *tree_column);

Возвращает текущий тип tree_column.

tree_column :

GtkTreeViewColumn.

Возвращает :

Тип tree_column.


gtk_tree_view_column_get_width ()

gint        gtk_tree_view_column_get_width  (GtkTreeViewColumn *tree_column);

Возвращает текущий размер tree_column в пикселах.

tree_column :

GtkTreeViewColumn.

Возвращает :

Текущая ширина tree_column.


gtk_tree_view_column_get_fixed_width ()

gint gtk_tree_view_column_get_fixed_width (GtkTreeViewColumn *tree_column);

Выдаёт фиксированную ширину столбца. Это значение означает только возможную, а не реальную ширину столбца на экране, что и требуется.

tree_column :

GtkTreeViewColumn

Возвращает :

Фиксированная ширина столбца.


gtk_tree_view_column_set_fixed_width ()

void gtk_tree_view_column_set_fixed_width (GtkTreeViewColumn *tree_column, gint fixed_width);

Устанавливает размер столбца в пикселах. Это имеет значение только если тип размера GTK_TREE_VIEW_COLUMN_FIXED. Размер столбца закрепляет min/max ширину столбца. Пожалуйста помните, что min/max ширина столбца не влияет на свойство "fixed_width" виджета, это просто фактический размер при отображении.

tree_column :

GtkTreeViewColumn.

fixed_width :

Размер устанавливаемый для tree_column. Должен быть больше 0.


gtk_tree_view_column_set_min_width ()

void gtk_tree_view_column_set_min_width (GtkTreeViewColumn *tree_column, gint min_width);

Устанавливает минимальную ширину tree_column. Если min_width равна -1, значит нет минимальной ширины.

tree_column :

GtkTreeViewColumn.

min_width :

Минимальная ширина столбца в пикселах, или -1.


gtk_tree_view_column_get_min_width ()

gint gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column);

Возвращает минимальную ширину в пикселах tree_column, или -1 если минимальная ширина не устанавливается.

tree_column :

GtkTreeViewColumn.

Возвращает :

Минимальная ширина tree_column.


gtk_tree_view_column_set_max_width ()

void gtk_tree_view_column_set_max_width (GtkTreeViewColumn *tree_column, gint max_width);

Устанавливает максимальную ширину tree_column. Если max_width равна -1, то когда максимальная ширина не устанавливается. Помните, столбец может быть шире этого максимума если он последний в поле просмотра. В этом случае, столбец заполняет всё доступное пространство.

tree_column :

GtkTreeViewColumn.

max_width :

Максимальная ширина столбца в пикселах, или -1.


gtk_tree_view_column_get_max_width ()

gint gtk_tree_view_column_get_max_width (GtkTreeViewColumn *tree_column);

Возвращает максимальную ширину tree_column, или -1 если максимальная ширина не установлена.

tree_column :

GtkTreeViewColumn.

Возвращает :

Максимальная ширина tree_column.


gtk_tree_view_column_clicked ()

void        gtk_tree_view_column_clicked    (GtkTreeViewColumn *tree_column);

Издаёт сигнал "clicked" на столбце. Эта функция работает только если tree_column доступен для нажатия.

tree_column :

GtkTreeViewColumn


gtk_tree_view_column_set_title ()

void gtk_tree_view_column_set_title (GtkTreeViewColumn *tree_column, const gchar *title);

Устанавливает заголовок tree_column. Если был установлен обычный виджет, то когда это значение игнорируется.

tree_column :

GtkTreeViewColumn.

title :

Заголовок tree_column.


gtk_tree_view_column_get_title ()

const gchar* gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column);

Возвращает заголовок виджета.

tree_column :

GtkTreeViewColumn.

Возвращает :

Заголовок столбца. Эта строка не должна изменяться или освобождаться.


gtk_tree_view_column_set_expand ()

void gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column, gboolean expand);

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

tree_column :

GtkTreeViewColumn

expand :

TRUE если столбец должен занимать свободное пространство, FALSE если нет

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


gtk_tree_view_column_get_expand ()

gboolean    gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column);

Возвращает TRUE если столбец расширяется на дополнительное пространство.

tree_column :

GtkTreeViewColumn

Возвращает :

TRUE, если столбец расширяем

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


gtk_tree_view_column_set_clickable ()

void gtk_tree_view_column_set_clickable (GtkTreeViewColumn *tree_column, gboolean clickable);

Устанавливает заголовок активным если active равен TRUE. Когда заголовок активен, он может брать клавиатурный фокус и может быть нажат.

tree_column :

GtkTreeViewColumn.

clickable :

TRUE если заголовок активный.


gtk_tree_view_column_get_clickable ()

gboolean gtk_tree_view_column_get_clickable (GtkTreeViewColumn *tree_column);

Возвращает TRUE если пользователь может нажать на заголовок столбца.

tree_column :

GtkTreeViewColumn

Возвращает :

TRUE если пользователь может нажать на заголовок.


gtk_tree_view_column_set_widget ()

void gtk_tree_view_column_set_widget (GtkTreeViewColumn *tree_column, GtkWidget *widget);

Устанавливает виджет в заголовке соответствующим widget. Если виджет NULL, то когда кнопка заголовка устанавливается с GtkLabel для заголовка tree_column.

tree_column :

GtkTreeViewColumn.

widget :

Дочерний GtkWidget, или NULL.


gtk_tree_view_column_get_widget ()

GtkWidget*  gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column);

Возвращает GtkWidget установленный в заголовке столбца. Если виджет не был установлен, возвращается NULL.

tree_column :

GtkTreeViewColumn.

Возвращает :

GtkWidget в заголовке столбца, или NULL


gtk_tree_view_column_set_alignment ()

void gtk_tree_view_column_set_alignment (GtkTreeViewColumn *tree_column, gfloat xalign);

Устанавливает выравнивание заголовка или встроенного виджета внутри заголовка столбца. Выравнивание определяет местоположение в кнопке -- 0.0 левое, 0.5 по центру, 1.0 правое.

tree_column :

GtkTreeViewColumn.

xalign :

Выравнивание, в диапазоне [0.0 и 1.0] включительно.


gtk_tree_view_column_get_alignment ()

gfloat gtk_tree_view_column_get_alignment (GtkTreeViewColumn *tree_column);

Возвращает текущеме x выравнивание tree_column. Это значение может находится в диапазоне между 0.0 и 1.0.

tree_column :

GtkTreeViewColumn.

Возвращает :

Текущее выравнивание tree_column.


gtk_tree_view_column_set_reorderable ()

void gtk_tree_view_column_set_reorderable (GtkTreeViewColumn *tree_column, gboolean reorderable);

Если reorderable равен TRUE, то когда столбец может быть перестроен конечным пользователем перетаскиванием заголовка.

tree_column :

GtkTreeViewColumn

reorderable :

TRUE, если столбец может быть перемещён.


gtk_tree_view_column_get_reorderable ()

gboolean gtk_tree_view_column_get_reorderable (GtkTreeViewColumn *tree_column);

Возвращает TRUE если tree_column может перестраиваться пользователем.

tree_column :

GtkTreeViewColumn

Возвращает :

TRUE если tree_column может перемещаться пользователем.


gtk_tree_view_column_set_sort_column_id ()

void gtk_tree_view_column_set_sort_column_id (GtkTreeViewColumn *tree_column, gint sort_column_id);

Устанавливает логический sort_column_id для сортировки столбца, когда он выбран. Это выполняется нажатием на заголовке столбца.

tree_column :

GtkTreeViewColumn

sort_column_id :

sort_column_id модели для включения сортировки.


gtk_tree_view_column_get_sort_column_id ()

gint gtk_tree_view_column_get_sort_column_id (GtkTreeViewColumn *tree_column);

Получает логическое sort_column_id, что модель сортируется когда этот столбец выбран для сортировки. Смотрите gtk_tree_view_column_set_sort_column_id().

tree_column :

GtkTreeViewColumn

Возвращает :

текущий sort_column_id для этого столбца, или -1 если этот столбец не сортируется.


gtk_tree_view_column_set_sort_indicator ()

void gtk_tree_view_column_set_sort_indicator (GtkTreeViewColumn *tree_column, gboolean setting);

Вызывает функцию с setting равным TRUE для отображения стрелки в кнопке заголовка указывающую что столбец сортирован. Вызовите gtk_tree_view_column_set_sort_order() для изменения направления стрелки.

tree_column :

GtkTreeViewColumn

setting :

TRUE для отображения индикатора что столбец отсортирован


gtk_tree_view_column_get_sort_indicator ()

gboolean gtk_tree_view_column_get_sort_indicator (GtkTreeViewColumn *tree_column);

Получает значение установленное с помощью gtk_tree_view_column_set_sort_indicator().

tree_column :

GtkTreeViewColumn

Возвращает :

Отображается ли индикатор сортировки


gtk_tree_view_column_set_sort_order ()

void gtk_tree_view_column_set_sort_order (GtkTreeViewColumn *tree_column, GtkSortType order);

Изменяет направление индикатора сортировки.

Это не сортирует модель. Используйте gtk_tree_view_column_set_sort_column_id() если вам нужна автоматическая поддержка сортировки. Эта функция прежде всего для обычного поведения сортировки, и должна использоваться вместе с gtk_tree_sortable_set_sort_column() для выполнения сортировки. Для обычных моделей, механизм варьируется.

Индикатор сортировки изменяет направление для указания нормальной или реверсивной сортировки. Помните, вы должны включить индикатор сортировки чтобы видеть что-нибудь при вызове этой функции; смотрите gtk_tree_view_column_set_sort_indicator().

tree_column :

GtkTreeViewColumn

order :

Порядок сортировки который должен показывать индикатор


gtk_tree_view_column_get_sort_order ()

GtkSortType gtk_tree_view_column_get_sort_order (GtkTreeViewColumn *tree_column);

Получает значение установленное с помощью gtk_tree_view_column_set_sort_order().

tree_column :

GtkTreeViewColumn

Возвращает :

Порядок сортировки указанный индикатором


gtk_tree_view_column_cell_set_cell_data ()

void gtk_tree_view_column_cell_set_cell_data (GtkTreeViewColumn *tree_column, GtkTreeModel *tree_model, GtkTreeIter *iter, gboolean is_expander, gboolean is_expanded);

Устанавливает ячейки отображения основываясь на tree_model и iter. Таким образом, для каждого параметра отображения в tree_column, она получит значение из установленного столбца на iter, и использует значение для установки параметров для ячейки отображения. Это используется прежде всего виджетом GtkTreeView.

tree_column :

GtkTreeViewColumn.

tree_model :

GtkTreeModel из которого получаются параметры ячейки отображения.

iter :

GtkTreeIter из которого получаются параметры ячейки отображения.

is_expander :

TRUE, если строка имеет дочерний элемент

is_expanded :

TRUE, если строка имеет дочерний элемент


gtk_tree_view_column_cell_get_size ()

void gtk_tree_view_column_cell_get_size (GtkTreeViewColumn *tree_column, GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height);

Определяет ширину и высоту необходимую для отображения столбца. Это в первую очередь используется виджетом GtkTreeView.

tree_column :

GtkTreeViewColumn.

cell_area :

Область расположенных в столбце ячеек, или NULL

x_offset :

x смещение ячейки относительно cell_area, или NULL

y_offset :

y смещение ячейки относительно cell_area, или NULL

width :

Ширина необходимая для отображения ячейки, или NULL

height :

Высота необходимая для отображения ячейки, или NULL


gtk_tree_view_column_cell_get_position ()

gboolean gtk_tree_view_column_cell_get_position (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, gint *start_pos, gint *width);

Определяет горизонтальную позицию и размер ячейки в столбце. Если ячейка не найдена в столбце, start_pos и width не изменяются и возвращается FALSE.

tree_column :

GtkTreeViewColumn

cell_renderer :

GtkCellRenderer

start_pos :

Место для хранения возвращаемого значения горизонтальной позиции cell внутри tree_column, может быть NULL

width :

Место для хранения возвращаемого значения ширины cell, может быть NULL

Возвращает :

TRUE если cell в границах tree_column.


gtk_tree_view_column_cell_is_visible ()

gboolean gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column);

Возвращает TRUE если любая из ячеек упакованных в tree_column является видимой. Сначала вы должны инициализировать ячейки с помощью gtk_tree_view_column_cell_set_cell_data()

tree_column :

GtkTreeViewColumn

Возвращает :

TRUE, если ячейка упакованная в tree_column в текущий момент видима


gtk_tree_view_column_focus_cell ()

void gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell);

Устанавливает текущий клавиатурный фокус на cell, если столбец содержит 2 или более редактируемых и активных ячеек.

tree_column :

GtkTreeViewColumn

cell :

GtkCellRenderer

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


gtk_tree_view_column_queue_resize ()

void gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column);

Отмечает столбец, и ячейку отображения добавленную в этот столбец, для пересмотра их размеров.

tree_column :

GtkTreeViewColumn

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

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

Свойство "alignment"

  "alignment"            gfloat                : Read / Write

X Выравнивание текста или виджета заголовка столбца.

Допустимые значения: [0,1]

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


Свойство "clickable"

  "clickable"            gboolean              : Read / Write

Может ли заголовок нажиматься.

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


Свойство "expand"

  "expand"               gboolean              : Read / Write

Столбец получает дополнительное пространство для расширения.

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


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

  "fixed-width"          gint                  : Read / Write

Текущая фиксированная ширина столбца.

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

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


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

  "max-width"            gint                  : Read / Write

Максимально допустимая ширина столбца.

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

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


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

  "min-width"            gint                  : Read / Write

Минимально допустимая ширина столбца.

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

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


Свойство "reorderable"

  "reorderable"          gboolean              : Read / Write

Возможность перестроения столбцов.

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


Свойство "resizable"

  "resizable"            gboolean              : Read / Write

Возможность изменения размера столбца пользователем.

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


Свойство "sizing"

  "sizing"               GtkTreeViewColumnSizing  : Read / Write

Режим изменения размера столбца.

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


Свойство "sort-indicator"

  "sort-indicator"       gboolean              : Read / Write

Отображается ли индикатор сортировки.

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


Свойство "sort-order"

  "sort-order"           GtkSortType           : Read / Write

Какое направление сортировки должен указывать индикатор.

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


Свойство "spacing"

  "spacing"              gint                  : Read / Write

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

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

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


Свойство "title"

  "title"                gchararray            : Read / Write

Заголовок столбца.

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


Свойство "visible"

  "visible"              gboolean              : Read / Write

Отображается ли столбец.

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


Свойство "widget"

  "widget"               GtkWidget             : Read / Write

Виджет помещаемый в кнопку заголовка столбца вместо текста.


Свойство "width"

  "width"                gint                  : Read

Текущая ширина столбца.

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

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

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

Сигнал "clicked"

void user_function (GtkTreeViewColumn *treeviewcolumn, gpointer user_data) : Run last

treeviewcolumn :

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

user_data :

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

Смотрите также

GtkTreeView, GtkTreeSelection, GtkTreeDnd, GtkTreeMode, GtkTreeSortable, GtkTreeModelSort, GtkListStore, GtkTreeStore, GtkCellRenderer, GtkCellEditable, GtkCellRendererPixbuf, GtkCellRendererText, GtkCellRendererToggle