GtkTreeViewColumn

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

			GTK+ Reference Manual
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` :	Пользовательские данные устанавливаемые при подключении обработчика сигнала.

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

GtkTreeViewColumn

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

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

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

Свойства

Сигналы

Описание

Детали

enum GtkTreeViewColumnSizing

GtkTreeCellDataFunc ()

GtkTreeViewColumn

gtk_tree_view_column_new ()

gtk_tree_view_column_new_with_attributes ()

gtk_tree_view_column_pack_start ()

gtk_tree_view_column_pack_end ()

gtk_tree_view_column_clear ()

gtk_tree_view_column_get_cell_renderers ()

gtk_tree_view_column_add_attribute ()

gtk_tree_view_column_set_attributes ()

gtk_tree_view_column_set_cell_data_func ()

gtk_tree_view_column_clear_attributes ()

gtk_tree_view_column_set_spacing ()

gtk_tree_view_column_get_spacing ()

gtk_tree_view_column_set_visible ()

gtk_tree_view_column_get_visible ()

gtk_tree_view_column_set_resizable ()

gtk_tree_view_column_get_resizable ()

gtk_tree_view_column_set_sizing ()

gtk_tree_view_column_get_sizing ()

gtk_tree_view_column_get_width ()

gtk_tree_view_column_get_fixed_width ()

gtk_tree_view_column_set_fixed_width ()

gtk_tree_view_column_set_min_width ()

gtk_tree_view_column_get_min_width ()

gtk_tree_view_column_set_max_width ()

gtk_tree_view_column_get_max_width ()

gtk_tree_view_column_clicked ()

gtk_tree_view_column_set_title ()

gtk_tree_view_column_get_title ()

gtk_tree_view_column_set_expand ()

gtk_tree_view_column_get_expand ()

gtk_tree_view_column_set_clickable ()

gtk_tree_view_column_get_clickable ()

gtk_tree_view_column_set_widget ()

gtk_tree_view_column_get_widget ()

gtk_tree_view_column_set_alignment ()

gtk_tree_view_column_get_alignment ()

gtk_tree_view_column_set_reorderable ()

gtk_tree_view_column_get_reorderable ()

gtk_tree_view_column_set_sort_column_id ()

gtk_tree_view_column_get_sort_column_id ()

gtk_tree_view_column_set_sort_indicator ()

gtk_tree_view_column_get_sort_indicator ()

gtk_tree_view_column_set_sort_order ()

gtk_tree_view_column_get_sort_order ()

gtk_tree_view_column_cell_set_cell_data ()

gtk_tree_view_column_cell_get_size ()

gtk_tree_view_column_cell_get_position ()

gtk_tree_view_column_cell_is_visible ()

gtk_tree_view_column_focus_cell ()

gtk_tree_view_column_queue_resize ()

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

Свойство "alignment"

Свойство "clickable"

Свойство "expand"

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

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

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

Свойство "reorderable"

Свойство "resizable"

Свойство "sizing"

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

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

Свойство "spacing"

Свойство "title"

Свойство "visible"

Свойство "widget"

Свойство "width"

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

Сигнал "clicked"

Свойство "`alignment`"

Свойство "`clickable`"

Свойство "`expand`"

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

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

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

Свойство "`reorderable`"

Свойство "`resizable`"

Свойство "`sizing`"

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

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

Свойство "`spacing`"

Свойство "`title`"

Свойство "`visible`"

Свойство "`widget`"

Свойство "`width`"