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

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

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

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

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

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

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. Если виджет NULL, то кнопка заголовка устанавливается с GtkLabel, установленным с названием tree_column.

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_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