GtkTreeViewColumn

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

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 для отображения ячеек.

gtk_tree_view_column_new_with_attributes ()

GtkTreeViewColumn *
gtk_tree_view_column_new_with_attributes
                               (const char *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 char *attribute,
                                    int 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,
                                  int spacing);

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

gtk_tree_view_column_get_spacing ()

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

int
gtk_tree_view_column_get_width (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_get_fixed_width ()

int
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,
                                      int fixed_width);

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

Наряду со свойством «expand», свойство «фиксированной ширины» изменяется при изменении размера столбца пользователем.

gtk_tree_view_column_set_min_width ()

void
gtk_tree_view_column_set_min_width (GtkTreeViewColumn *tree_column,
                                    int min_width);

Устанавливает минимальную ширину tree_column . Если min_width равно -1, то минимальная ширина сбрасывается.

gtk_tree_view_column_get_min_width ()

int
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,
                                    int max_width);

Устанавливает максимальную ширину tree_column . Если max_width равно -1, то максимальная ширина сбрасывается. Обратите внимание, что столбец фактически может быть шире максимальной ширины, если это последний столбец в представлении. В этом случае столбец расширяется, чтобы заполнить всё дополнительное пространство.

gtk_tree_view_column_get_max_width ()

int
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 char *title);

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

gtk_tree_view_column_get_title ()

const char *
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» меняется при изменении размера столбца пользователем.

gtk_tree-view-column-get-expand ()

gboolean
gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column);

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

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.

gtk_tree_view_column_set_alignment ()

void
gtk_tree_view_column_set_alignment (GtkTreeViewColumn *tree_column,
                                    float xalign);

Устанавливает выравнивание заголовка или пользовательского виджета внутри заголовка столбца. Выравнивание определяет его расположение внутри кнопки — 0,0 для левого, 0,5 для центрального, 1,0 для правого.

gtk_tree-view-column_get_alignment ()

float
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, если tree_column можно переупорядочить пользователем.

gtk_tree_view_column_set_sort_column_id ()

void
gtk_tree_view_column_set_sort_column_id
                               (GtkTreeViewColumn *tree_column,
                                int sort_column_id);

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

gtk_tree_view_column_get_sort_column_id ()

int
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,
                                    int *x_offset,
                                    int *y_offset,
                                    int *width,
                                    int *height);

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

gtk_tree_view_column_cell_get_position ()

gboolean
gtk_tree_view_column_cell_get_position
                               (GtkTreeViewColumn *tree_column,
                                GtkCellRenderer *cell_renderer,
                                int *x_offset,
                                int *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 или более редактируемых и активируемых ячеек.

gtk_tree_view_column_queue_resize ()

void
gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_get_tree_view ()

GtkWidget *
gtk_tree_view_column_get_tree_view (GtkTreeViewColumn *tree_column);

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

gtk_tree_view_column_get_x_offset ()

int
gtk_tree_view_column_get_x_offset (GtkTreeViewColumn *tree_column);

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