GtkTreeViewColumn

GtkTreeCellDataFunc ()

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

Функция для установки свойств ячейки вместо прямого сопоставления ячейки и модели. Это полезно для настройки рендерера ячейки. Например, функция может получить целое число из tree_model и отобразить его в атрибуте «текст» ячейки «cell», преобразовав его в письменный вид. Эта функция устанавливается вызовом 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 модели содержит строки, вы можете настроить атрибут «текст» 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 ограничено минимальной и максимальной шириной столбца; однако, значение, хранящееся в свойстве «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” изменяется при изменении размера колонки пользователем.

Since: 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. Если 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);

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

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_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 или более редактируемых и активируемых ячеек.

Since: 2.2

gtk_tree_view_column_queue_resize ()

void
gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column);

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

Since: 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.

Since: 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

Свойство “alignment”

  “alignment”                gfloat

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

Флаги: Чтение / Запись

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

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

Свойство “cell-area”

  “cell-area”                GtkCellArea *

Объект GtkCellArea, используемый для компоновки элементов отображения ячеек для этой колонки.

Если при создании колонки дерева с помощью gtk_tree_view_column_new_with_area() область не указана, будет использована горизонтальная область GtkCellAreaBox.

Флаги: Чтение / Запись / Только для создания

С версии: 3.0

Свойство “clickable”

  “clickable”                gboolean

Можно ли щелкнуть по заголовку.

Флаги: Чтение / Запись

Значение по умолчанию: ЛОЖЬ

Свойство “expand”

  “expand”                   gboolean

Колонка получает часть дополнительной ширины, выделенной виджету.

Флаги: Чтение / Запись

Значение по умолчанию: ЛОЖЬ

Свойство “fixed-width”

  “fixed-width”              gint

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

Флаги: Чтение / Запись

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

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

Свойство “max-width”

  “max-width”                gint

Максимальная разрешенная ширина колонки.

Флаги: Чтение / Запись

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

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

Свойство “min-width”

  “min-width”                gint

Минимальная разрешенная ширина колонки.

Флаги: Чтение / Запись

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

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

Свойство “reorderable”

  “reorderable”              gboolean

Можно ли переупорядочить колонку вокруг заголовков.

Флаги: Чтение / Запись

Значение по умолчанию: ЛОЖЬ

Свойство “resizable”

  “resizable”                gboolean

Столбец может быть изменён пользователем.

Флаги: Чтение / Запись

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

Свойство “sizing”

  “sizing”                   GtkTreeViewColumnSizing

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

Флаги: Чтение / Запись

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

Свойство “sort-column-id”

  “sort-column-id”           gint

Логический идентификатор столбца сортировки, по которому этот столбец сортируется при выборе для сортировки. Установка идентификатора столбца сортировки делает заголовок столбца нажимаемым. Установите в -1, чтобы сделать столбец несортируемым.

Флаги: Чтение / Запись

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

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

С: 2.18

Свойство “sort-indicator”

  “sizing”                   GtkTreeViewColumnSizing

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

Флаги: Чтение / Запись

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

Свойство “sort-order”

  “sort-order”               GtkSortType

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

Флаги: Чтение / Запись

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

Свойство “spacing”

  “spacing”                  gint

Пробел, который вставляется между ячейками.

Флаги: Чтение / Запись

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

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

Свойство “title”

  “title”                    gchar *

Заголовок, который должен отображаться в заголовке столбца.

Флаги: Чтение / Запись

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

Свойство “visible”

  “visible”                  gboolean

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

Флаги: Чтение / Запись

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

Свойство “widget”

  “widget”                   GtkWidget *

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

Флаги: Чтение / Запись

Свойство “width”

  “width”                    gint

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

Флаги: Чтение

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

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

Свойство “x-offset”

  “x-offset”                 gint

Текущее положение X столбца.

Флаги: Чтение

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

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