GtkTreeViewColumn

GtkTreeCellDataFunc ()

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

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

gtk_tree_view_column_new ()

GtkTreeViewColumn *
gtk_tree_view_column_new (void);

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

gtk_tree_view_column_new_with_area ()

GtkTreeViewColumn *
gtk_tree_view_column_new_with_area (GtkCellArea *area);

Создаёт новый GtkTreeViewColumn, используя area для отображения ячеек.

С версии: 3.0

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);
}

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.

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.

gtk_tree_view_column_clear ()

void
gtk_tree_view_column_clear (GtkTreeViewColumn *tree_column);

Удаляет все сопоставления для всех визуализаций в tree_column .

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.

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(). Все существующие атрибуты удаляются и заменяются новыми.

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,
                                GDestroyNotify destroy);

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

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().

gtk_tree_view_column_set_spacing ()

void
gtk_tree_view_column_set_spacing (GtkTreeViewColumn *tree_column,
                                  gint spacing);

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

gtk_tree_view_column_get_spacing ()

gint
gtk_tree_view_column_get_spacing (GtkTreeViewColumn *tree_column);

Возвращает отступ tree_column.

gtk_tree_view_column_set_visible ()

void
gtk_tree_view_column_set_visible (GtkTreeViewColumn *tree_column,
                                  gboolean visible);

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

gtk_tree_view_column_get_visible ()

gboolean
gtk_tree_view_column_get_visible (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_set_resizable ()

void
gtk_tree_view_column_set_resizable (GtkTreeViewColumn *tree_column,
                                    gboolean resizable);

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

gtk_tree_view_column_get_resizable ()

gboolean
gtk_tree_view_column_get_resizable (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_set_sizing ()

void
gtk_tree_view_column_set_sizing (GtkTreeViewColumn *tree_column,
                                 GtkTreeViewColumnSizing type);

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

gtk_tree_view_column_get_sizing ()

GtkTreeViewColumnSizing
gtk_tree_view_column_get_sizing (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_get_width ()

gint
gtk_tree_view_column_get_width (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_get_fixed_width ()

gint
gtk_tree_view_column_get_fixed_width (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_set_fixed_width ()

void
gtk_tree_view_column_set_fixed_width (GtkTreeViewColumn *tree_column,
                                      gint fixed_width);

Если fixed_width не равно -1, устанавливает фиксированную ширину tree_column; в противном случае отменяет её. Эффективное значение fixed_width ограничено минимальной и максимальной шириной столбца; однако, значение, хранящееся в свойстве «фиксированной ширины», не ограничено. Если размер столбца задан как GTK_TREE_VIEW_COLUMN_GROW_ONLY или GTK_TREE_VIEW_COLUMN_AUTOSIZE, установка фиксированной ширины переопределяет автоматически вычисленную ширину. Обратите внимание, что fixed_width — это лишь подсказка для GTK+; фактическая ширина, выделенная для столбца, может быть больше или меньше запрошенной.

Вместе с «expand», свойство «fixed-width» изменяется при изменении пользователем размера столбца.

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, то минимальная ширина не устанавливается.

gtk_tree_view_column_get_min_width ()

gint
gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column);

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

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, максимальная ширина не устанавливается. Столбец может быть шире, чем максимальная ширина, если он является последним в представлении. В этом случае столбец расширяется, чтобы заполнить любое дополнительное пространство.

gtk_tree_view_column_get_max_width ()

gint
gtk_tree_view_column_get_max_width (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_clicked ()

void
gtk_tree_view_column_clicked (GtkTreeViewColumn *tree_column);

Вызывает сигнал «clicked» на столбце. Эта функция будет работать только если tree_column нажимабелен.

gtk_tree_view_column_set_title ()

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

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

gtk_tree_view_column_get_title ()

const gchar *
gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_set_expand ()

void
gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column,
                                 gboolean expand);

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

Вместе с «fixed-width», свойство «expand» изменяется при изменении размера столбца пользователем.

С: 2.4

gtk_tree_view_column_get_expand ()

gboolean
gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column);

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

С: 2.4

gtk_tree_view_column_set_clickable ()

void
gtk_tree_view_column_set_clickable (GtkTreeViewColumn *tree_column,
                                    gboolean clickable);

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

gtk_tree_view_column_get_clickable ()

gboolean
gtk_tree_view_column_get_clickable (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_set_widget ()

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

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

gtk_tree_view_column_get_widget ()

GtkWidget *
gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_get_button ()

GtkWidget *
gtk_tree_view_column_get_button (GtkTreeViewColumn *tree_column);

Возвращает кнопку, используемую в заголовке столбца treeview

С: 3.0

gtk_tree-view-column-set-alignment ()

void
gtk_tree_view_column_set_alignment (GtkTreeViewColumn *tree_column,
                                    gfloat xalign);

Устанавливает выравнивание заголовка или пользовательского виджета внутри заголовка столбца. Выравнивание определяет его положение внутри кнопки — 0.0 для левого, 0.5 для центрального, 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.

gtk_tree_view_column_set_reorderable ()

void
gtk_tree_view_column_set_reorderable (GtkTreeViewColumn *tree_column,
                                      gboolean reorderable);

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

gtk_tree_view_column_get_reorderable ()

gboolean
gtk_tree_view_column_get_reorderable (GtkTreeViewColumn *tree_column);

Возвращает TRUE, если столбец может быть переупорядочен пользователем.

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, по которому сортируется столбец при его выборе для сортировки. Это делает заголовок столбца кликабельным.

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().

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(), чтобы изменить направление стрелки.

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().

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_id() для этой цели. Для пользовательских моделей механизм будет отличаться.

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

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().

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.

gtk_tree_view_column_cell_get_size ()

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

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

gtk_tree_view_column_cell_get_position ()

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

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

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()

gtk_tree_view_column_focus_cell ()

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

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

С: 2.2

gtk_tree_view_column_queue_resize ()

void
gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column);

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

С: 2.8

gtk_tree_view_column_get_tree_view ()

GtkWidget *
gtk_tree_view_column_get_tree_view (GtkTreeViewColumn *tree_column);

Возвращает GtkTreeView, в котором tree_column был вставлен. Если column в данный момент не вставлен ни в какой вид дерева, возвращается NULL.

С: 2.12

gtk_tree_view_column_get_x_offset ()

gint
gtk_tree_view_column_get_x_offset (GtkTreeViewColumn *tree_column);

Возвращает текущее смещение X для tree_column в пикселях.

С: 3.2