Wiki
Задать вопрос на форуме...

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