GTK+ Reference Manual |
||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
GtkTreeViewColumnGtkTreeViewColumn Видимый столбец в виджете 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 который кратко описывает все объекты и типы данных связанные с виджетом дерева просмотра и как они взаимодействуют.
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 |
Столбцы имеют фиксированную ширину в пикселах. |
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 : |
Пользовательские данные |
typedef struct _GtkTreeViewColumn GtkTreeViewColumn;
gtk_tree_view_column_new ()
GtkTreeViewColumn* gtk_tree_view_column_new (void);Создаёт новый GtkTreeViewColumn.
Возвращает : |
Вновь созданный GtkTreeViewColumn. |
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 : |
|
... : |
NULL-завершенный список параметров. |
Возвращает : |
Вновь созданный GtkTreeViewColumn. |
void gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column,
GtkCellRenderer *cell,
gboolean expand);
Упаковывает cell в начало столбца. Если expand равно FALSE, то когда cell не занимает больше свободного пространства чем нужно. Любое свободное пространство распределяется между ячейками для которых expand равен TRUE.
tree_column : |
|
cell : |
|
expand : |
TRUE если cell нужно дать дополнительное пространство распределённое для tree_column. |
void gtk_tree_view_column_pack_end (GtkTreeViewColumn *tree_column,
GtkCellRenderer *cell,
gboolean expand);
Добавляет cell в конец столбца. Если expand равно FALSE, то когда cell не занимает больше пространства чем необходимо. Любое свободное пространство распределяется между ячейками для которых expand равен TRUE.
tree_column : |
|
cell : |
|
expand : |
TRUE если cell нужно дать дополнительное пространство распределённое для tree_column. |
void gtk_tree_view_column_clear (GtkTreeViewColumn *tree_column);Очищает все отображение в tree_column.
tree_column : |
GList* gtk_tree_view_column_get_cell_renderers
(GtkTreeViewColumn *tree_column);
Возвращает вновь созданный GList всех ячеек отображения в столбце, в неопределенном порядке. Список должен освобождаться с помощью g_list_free().
tree_column : |
|
Возвращает : |
Список GtkCellRenderers |
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 : |
|
cell_renderer : |
GtkCellRenderer для установки параметров |
attribute : |
Параметр отображения |
column : |
Позиция столбца в модели из которого получается параметр. |
void gtk_tree_view_column_set_attributes
(GtkTreeViewColumn *tree_column,
GtkCellRenderer *cell_renderer,
...);
Устанавливает параметр в список параметров tree_column. Параметры должны быть в порядке параметр/столбец, как в gtk_tree_view_column_add_attribute(). Все существующие параметры удаляются, и устанавливаются новые параметры.
tree_column : |
|
cell_renderer : |
GtkCellRenderer куда устанавливаются параметры |
... : |
NULL-завершенный список параметров. |
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 : |
|
cell_renderer : |
|
func : |
используемая GtkTreeViewColumnFunc. |
func_data : |
Пользовательские данные для func. |
destroy : |
Разрушающее уведомление для func_data |
void gtk_tree_view_column_clear_attributes
(GtkTreeViewColumn *tree_column,
GtkCellRenderer *cell_renderer);
Очищает все параметры предварительно установленные с помощью gtk_tree_view_column_set_attributes().
tree_column : |
|
cell_renderer : |
GtkCellRenderer для очищения параметров отображения. |
void gtk_tree_view_column_set_spacing
(GtkTreeViewColumn *tree_column,
gint spacing);
Устанавливает поле интервала tree_column, которое является числом пикселей помещаемых между ячейками представления.
tree_column : |
|
spacing : |
Расстояние между ячейками в пикселах. |
gint gtk_tree_view_column_get_spacing
(GtkTreeViewColumn *tree_column);
Возвращает интервал tree_column.
tree_column : |
|
Возвращает : |
интервал tree_column. |
void gtk_tree_view_column_set_visible
(GtkTreeViewColumn *tree_column,
gboolean visible);
Устанавливает видимость tree_column.
tree_column : |
|
visible : |
TRUE если tree_column видим. |
gboolean gtk_tree_view_column_get_visible
(GtkTreeViewColumn *tree_column);
Возвращает TRUE если tree_column видим.
tree_column : |
|
Возвращает : |
Видим ли столбец или нет. Если он видим, то когда дерево показывает его. |
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 : |
|
resizable : |
TRUE, если столбец может изменять размер |
gboolean gtk_tree_view_column_get_resizable
(GtkTreeViewColumn *tree_column);
Возвращает TRUE если размер tree_column может быть изменен конечным пользователем.
tree_column : |
|
Возвращает : |
TRUE, если размер tree_column может изменяться. |
void gtk_tree_view_column_set_sizing (GtkTreeViewColumn *tree_column,
GtkTreeViewColumnSizing type);
Устанавливает поведение роста tree_column в type.
tree_column : |
|
type : |
GtkTreeViewColumnSizing gtk_tree_view_column_get_sizing
(GtkTreeViewColumn *tree_column);
Возвращает текущий тип tree_column.
tree_column : |
|
Возвращает : |
Тип tree_column. |
gint gtk_tree_view_column_get_width (GtkTreeViewColumn *tree_column);Возвращает текущий размер tree_column в пикселах.
tree_column : |
|
Возвращает : |
Текущая ширина tree_column. |
gint gtk_tree_view_column_get_fixed_width
(GtkTreeViewColumn *tree_column);
Выдаёт фиксированную ширину столбца. Это значение означает только возможную, а не реальную ширину столбца на экране, что и требуется.
tree_column : |
|
Возвращает : |
Фиксированная ширина столбца. |
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 : |
|
fixed_width : |
Размер устанавливаемый для tree_column. Должен быть больше 0. |
void gtk_tree_view_column_set_min_width
(GtkTreeViewColumn *tree_column,
gint min_width);
Устанавливает минимальную ширину tree_column. Если min_width равна -1, значит нет минимальной ширины.
tree_column : |
|
min_width : |
Минимальная ширина столбца в пикселах, или -1. |
gint gtk_tree_view_column_get_min_width
(GtkTreeViewColumn *tree_column);
Возвращает минимальную ширину в пикселах tree_column, или -1 если минимальная ширина не устанавливается.
tree_column : |
|
Возвращает : |
Минимальная ширина tree_column. |
void gtk_tree_view_column_set_max_width
(GtkTreeViewColumn *tree_column,
gint max_width);
Устанавливает максимальную ширину tree_column. Если max_width равна -1, то когда максимальная ширина не устанавливается. Помните, столбец может быть шире этого максимума если он последний в поле просмотра. В этом случае, столбец заполняет всё доступное пространство.
tree_column : |
|
max_width : |
Максимальная ширина столбца в пикселах, или -1. |
gint gtk_tree_view_column_get_max_width
(GtkTreeViewColumn *tree_column);
Возвращает максимальную ширину tree_column, или -1 если максимальная ширина не установлена.
tree_column : |
|
Возвращает : |
Максимальная ширина tree_column. |
void gtk_tree_view_column_clicked (GtkTreeViewColumn *tree_column);Издаёт сигнал "clicked" на столбце. Эта функция работает только если tree_column доступен для нажатия.
tree_column : |
void gtk_tree_view_column_set_title (GtkTreeViewColumn *tree_column,
const gchar *title);
Устанавливает заголовок tree_column. Если был установлен обычный виджет, то когда это значение игнорируется.
tree_column : |
|
title : |
Заголовок tree_column. |
const gchar* gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column);Возвращает заголовок виджета.
tree_column : |
|
Возвращает : |
Заголовок столбца. Эта строка не должна изменяться или освобождаться. |
void gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column,
gboolean expand);
Заставляет столбец занимать дополнительное пространство. Это пространство одинаково разделяется между всеми столбцами имеющих expand установленный в TRUE. Если нет столбца с этой опцией, то когда последний столбец получает всё свободное пространство. П умолчанию, столбцы создаются с этим значением установленным в FALSE.
tree_column : |
|
expand : |
TRUE если столбец должен занимать свободное пространство, FALSE если нет |
Начиная с версии 2.4
gboolean gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column);Возвращает TRUE если столбец расширяется на дополнительное пространство.
tree_column : |
|
Возвращает : |
TRUE, если столбец расширяем |
Начиная с версии 2.4
void gtk_tree_view_column_set_clickable
(GtkTreeViewColumn *tree_column,
gboolean clickable);
Устанавливает заголовок активным если active равен TRUE. Когда заголовок активен, он может брать клавиатурный фокус и может быть нажат.
tree_column : |
|
clickable : |
TRUE если заголовок активный. |
gboolean gtk_tree_view_column_get_clickable
(GtkTreeViewColumn *tree_column);
Возвращает TRUE если пользователь может нажать на заголовок столбца.
tree_column : |
|
Возвращает : |
TRUE если пользователь может нажать на заголовок. |
void gtk_tree_view_column_set_widget (GtkTreeViewColumn *tree_column,
GtkWidget *widget);
Устанавливает виджет в заголовке соответствующим widget. Если виджет NULL, то когда кнопка заголовка устанавливается с GtkLabel для заголовка tree_column.
tree_column : |
|
widget : |
Дочерний GtkWidget, или NULL. |
GtkWidget* gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column);Возвращает GtkWidget установленный в заголовке столбца. Если виджет не был установлен, возвращается NULL.
tree_column : |
|
Возвращает : |
GtkWidget в заголовке столбца, или NULL |
void gtk_tree_view_column_set_alignment
(GtkTreeViewColumn *tree_column,
gfloat xalign);
Устанавливает выравнивание заголовка или встроенного виджета внутри заголовка столбца. Выравнивание определяет местоположение в кнопке -- 0.0 левое, 0.5 по центру, 1.0 правое.
tree_column : |
|
xalign : |
Выравнивание, в диапазоне [0.0 и 1.0] включительно. |
gfloat gtk_tree_view_column_get_alignment
(GtkTreeViewColumn *tree_column);
Возвращает текущеме x выравнивание tree_column. Это значение может находится в диапазоне между 0.0 и 1.0.
tree_column : |
|
Возвращает : |
Текущее выравнивание tree_column. |
void gtk_tree_view_column_set_reorderable
(GtkTreeViewColumn *tree_column,
gboolean reorderable);
Если reorderable равен TRUE, то когда столбец может быть перестроен конечным пользователем перетаскиванием заголовка.
tree_column : |
|
reorderable : |
TRUE, если столбец может быть перемещён. |
gboolean gtk_tree_view_column_get_reorderable
(GtkTreeViewColumn *tree_column);
Возвращает TRUE если tree_column может перестраиваться пользователем.
tree_column : |
|
Возвращает : |
TRUE если tree_column может перемещаться пользователем. |
void gtk_tree_view_column_set_sort_column_id
(GtkTreeViewColumn *tree_column,
gint sort_column_id);
Устанавливает логический sort_column_id для сортировки столбца, когда он выбран. Это выполняется нажатием на заголовке столбца.
tree_column : |
|
sort_column_id : |
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 : |
|
Возвращает : |
текущий sort_column_id для этого столбца, или -1 если этот столбец не сортируется. |
void gtk_tree_view_column_set_sort_indicator
(GtkTreeViewColumn *tree_column,
gboolean setting);
Вызывает функцию с setting равным TRUE для отображения стрелки в кнопке заголовка указывающую что столбец сортирован. Вызовите gtk_tree_view_column_set_sort_order() для изменения направления стрелки.
tree_column : |
|
setting : |
TRUE для отображения индикатора что столбец отсортирован |
gboolean gtk_tree_view_column_get_sort_indicator
(GtkTreeViewColumn *tree_column);
Получает значение установленное с помощью gtk_tree_view_column_set_sort_indicator().
tree_column : |
|
Возвращает : |
Отображается ли индикатор сортировки |
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 : |
|
order : |
Порядок сортировки который должен показывать индикатор |
GtkSortType gtk_tree_view_column_get_sort_order
(GtkTreeViewColumn *tree_column);
Получает значение установленное с помощью gtk_tree_view_column_set_sort_order().
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);
Устанавливает ячейки отображения основываясь на tree_model и iter. Таким образом, для каждого параметра отображения в tree_column, она получит значение из установленного столбца на iter, и использует значение для установки параметров для ячейки отображения. Это используется прежде всего виджетом GtkTreeView.
tree_column : |
|
tree_model : |
GtkTreeModel из которого получаются параметры ячейки отображения. |
iter : |
GtkTreeIter из которого получаются параметры ячейки отображения. |
is_expander : |
TRUE, если строка имеет дочерний элемент |
is_expanded : |
TRUE, если строка имеет дочерний элемент |
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 : |
|
cell_area : |
Область расположенных в столбце ячеек, или NULL |
x_offset : |
x смещение ячейки относительно cell_area, или NULL |
y_offset : |
y смещение ячейки относительно cell_area, или NULL |
width : |
Ширина необходимая для отображения ячейки, или NULL |
height : |
Высота необходимая для отображения ячейки, или NULL |
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 : |
|
cell_renderer : |
|
start_pos : |
Место для хранения возвращаемого значения горизонтальной позиции cell внутри tree_column, может быть NULL |
width : |
Место для хранения возвращаемого значения ширины cell, может быть NULL |
Возвращает : |
TRUE если cell в границах tree_column. |
gboolean gtk_tree_view_column_cell_is_visible
(GtkTreeViewColumn *tree_column);
Возвращает TRUE если любая из ячеек упакованных в tree_column является видимой. Сначала вы должны инициализировать ячейки с помощью gtk_tree_view_column_cell_set_cell_data()
tree_column : |
|
Возвращает : |
TRUE, если ячейка упакованная в tree_column в текущий момент видима |
void gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column,
GtkCellRenderer *cell);
Устанавливает текущий клавиатурный фокус на cell, если столбец содержит 2 или более редактируемых и активных ячеек.
tree_column : |
|
cell : |
Начиная с версии 2.2
void gtk_tree_view_column_queue_resize
(GtkTreeViewColumn *tree_column);
Отмечает столбец, и ячейку отображения добавленную в этот столбец, для пересмотра их размеров.
tree_column : |
Начиная с версии 2.8
"alignment" gfloat : Read / WriteX Выравнивание текста или виджета заголовка столбца.
Допустимые значения: [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