GtkCellArea

Запрос размеров области

Как описано в разделе управления геометрией GtkWidget, GTK+ использует систему управления геометрией "высота для ширины" для вычисления размеров виджетов и пользовательских интерфейсов. GtkCellArea использует те же семантики для вычисления размера области для произвольного количества строк GtkTreeModel.

При запросе размера области ячейки необходимо вычислить размер для нескольких строк, и это будет выполняться по-разному различными виджетами компоновки. Например, GtkTreeViewColumn всегда выстраивает области сверху вниз, в то время как GtkIconView может потребовать, чтобы все области имели одинаковую ширину и располагали области по очереди, запрашивая высоту для дополнительных областей ячеек при выделении меньшей ширины.

Также важно, чтобы области сохраняли выравнивание ячеек с областями, отрисованными для смежных строк (ячейки могут отображаться «колонообразно» внутри области, даже если размеры ячеек разные в каждой строке). По этой причине GtkCellArea использует объект GtkCellAreaContext для хранения выравниваний и размеров по ходу выполнения (а также общий максимальный минимальный и естественный размер для всех строк, которые были вычислены с использованием указанного контекста).

Объект GtkCellAreaContext — это неявный объект, специфичный для GtkCellArea, который его создал (см. gtk_cell_area_create_context()). Владеющий виджет компоновки ячеек может создавать столько контекстов, сколько ему нужно, чтобы вычислить размеры строк, которые должны получить одинаковый размер по крайней мере в одной ориентации (горизонтально или вертикально). Однако важно, чтобы тот же GtkCellAreaContext, который использовался для запроса размеров для заданной строки GtkTreeModel, использовался при отрисовке или обработке событий для этой строки.

Чтобы запросить ширину всех строк на корневом уровне GtkTreeModel, выполните следующие действия:

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

Это может быть полезно, поскольку виджеты GtkCellLayout обычно должны поддерживать запрос и отрисовку строк в моделях дерева с чрезвычайно большим количеством строк. Виджет GtkCellLayout в этом случае вычислит требуемую ширину строк в источнике бездействия или тайм-аута (см. g_timeout_add()), и когда виджет запрошен своей фактической шириной в GtkWidgetClass.get_preferred_width(), он может просто проконсультироваться с накопленной шириной в объекте GtkCellAreaContext.

Простой пример, где строки отрисовываются сверху вниз и занимают всю ширину виджета компоновки, будет выглядеть так:

В приведенном выше примере виджет Foo должен убедиться, что некоторые размеры строк были вычислены (количество строк, которое Foo посчитал уместным для запроса места в одной итерации таймаута), прежде чем просто возвращать требуемое место для области через GtkCellAreaContext.

Запрос высоты для ширины (или ширины для высоты) области — аналогичная задача, за исключением того, что в этом случае GtkCellAreaContext не хранит данные (на самом деле, он не знает, сколько места виджет компоновки планирует выделять для каждой строки. За виджетом компоновки остается задача отрисовать каждую строку данных с соответствующей высотой и шириной, которые были запрошены GtkCellArea).

Чтобы запросить высоту для ширины всех строк на корневом уровне GtkTreeModel, выполните следующие действия:

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

В некоторых случаях виджет компоновки запрошен высотой для произвольной ширины, это особый случай для виджетов компоновки, которым необходимо запросить размер для десятков тысяч строк. В этом случае важно, чтобы виджет компоновки вычислил один разумный блок строк и синхронно вернул эту высоту. Причина в том, что любой виджет компоновки, по крайней мере, способен синхронно вычислить достаточно высоты, чтобы заполнить высоту экрана (или высоту окна прокрутки) в ответ на один вызов GtkWidgetClass.get_preferred_height_for_width(). Возврат точной высоты для ширины, большей, чем область экрана, несущественен, так как после того, как виджет компоновки получит выделение от окна прокрутки, он просто продолжает управлять значениями полосы прокрутки, пока не потребуется больше высоты для вычисленных высот строк в фоновом режиме.

Отрисовка областей

После получения размеров областей, по крайней мере, для строк в видимой области виджета компоновки, они могут быть отрисованы во время GtkWidgetClass.draw().

Грубый пример того, как отрисовать все строки на корневом уровне, выглядит следующим образом:

Обратите внимание, что кэшированная высота в этом примере действительно зависит от того, как работает виджет компоновки. Виджет компоновки может решить присвоить каждой строке минимальную или естественную высоту, или, если ожидается, что содержимое модели поместится внутри виджета компоновки без прокрутки, имеет смысл рассчитать выделение для каждой строки во время “size-allocate” с использованием gtk_distribute_natural_allocation().

Обработка событий и управление фокусом клавиатуры

Передача событий в область так же проста, как обработка событий на любом обычном виджете, а затем их передача в API gtk_cell_area_event() по мере их поступления. Обычно GtkCellArea интересуется только событиями нажатия кнопок, однако можно реализовать некоторые настраиваемые производные области, которые заинтересованы в обработке других событий. Обработка события может привести к запуску сигнала “focus-changed”, а также “add-editable” в случае, если была нажата редактируемая ячейка, и необходимо начать редактирование. Вы можете вызвать gtk_cell_area_stop_editing() в любое время, чтобы отменить любое редактирование ячейки, которое в настоящее время выполняется.

GtkCellArea управляет фокусом клавиатуры от ячейки к ячейке аналогично GtkWidget. Для виджетов компоновки, которые поддерживают предоставление фокуса ячейкам, важно помнить, что нужно передать GTK_CELL_RENDERER_FOCUSED функциям области для строки, имеющей фокус, и указать области нарисовать фокус во время отрисовки.

Виджеты компоновки, которые принимают фокус в ячейках, должны реализовать виртуальный метод GtkWidgetClass.focus(). Виджет компоновки всегда несет ответственность за знание того, где строки GtkTreeModel отрисовываются внутри виджета, поэтому во время GtkWidgetClass.focus() виджет компоновки должен использовать методы GtkCellArea для навигации по фокусу внутри области, а затем просмотреть GtkDirectionType для передачи фокуса в смежные строки и области.

Базовый пример того, как должен быть реализован виртуальный метод GtkWidgetClass.focus():

GtkTreeIter iter;
gint        minimum_width;
gint        natural_width;

valid = gtk_tree_model_get_iter_first (model, &iter);
while (valid)
  {
    gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
    gtk_cell_area_get_preferred_width (area, context, widget, NULL, NULL);

    valid = gtk_tree_model_iter_next (model, &iter);
  }
gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width);

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

Свойства ячеек

Класс GtkCellArea вводит свойства ячеек для GtkCellRenderers очень похожим образом, как GtkContainer вводит свойства дочерних элементов для GtkWidgets. Это предоставляет некоторые общие интерфейсы для определения отношений между областями ячеек и самими ячейками. Например, в GtkCellAreaBox ячейка может «расширяться» и получать дополнительное пространство, когда области выделяется больше, чем её естественный размер, или ячейка может быть настроена на «выравнивание» с соседними строками, которые были запрошены и отрисованы с тем же GtkCellAreaContext.

Используйте gtk_cell_area_class_install_cell_property() для установки свойств ячеек для класса области ячеек и gtk_cell_area_class_find_cell_property() или gtk_cell_area_class_list_cell_properties() для получения информации о существующих свойствах ячеек.

Для установки значения свойства ячейки используйте gtk_cell_area_cell_set_property(), gtk_cell_area_cell_set() или gtk_cell_area_cell_set_valist(). Для получения значения свойства ячейки используйте gtk_cell_area_cell_get_property(), gtk_cell_area_cell_get() или gtk_cell_area_cell_get_valist().

GtkCellCallback ()

gboolean
(*GtkCellCallback) (GtkCellRenderer *renderer,
                    gpointer data);

Тип обратных функций, используемых для итерирования по рендерерам ячеек GtkCellArea, см. gtk_cell_area_foreach().

GtkCellAllocCallback ()

gboolean
(*GtkCellAllocCallback) (GtkCellRenderer *renderer,
                         const GdkRectangle *cell_area,
                         const GdkRectangle *cell_background,
                         gpointer data);

Тип обратных функций, используемых для итерирования по рендерерам ячеек и их выделенным областям внутри GtkCellArea, см. gtk_cell_area_foreach_alloc().

GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID()

#define             GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID(object, property_id, pspec)

Эта макрокоманда должна использоваться для вывода стандартного предупреждения об неожиданных свойствах в set_cell_property() и get_cell_property() реализациях.

gtk_cell_area_add ()

void
gtk_cell_area_add (GtkCellArea *area,
                   GtkCellRenderer *renderer);

Добавляет renderer в area с типовыми свойствами дочерней ячейки.

С: 3.0

gtk_cell_area_remove ()

void
gtk_cell_area_remove (GtkCellArea *area,
                      GtkCellRenderer *renderer);

Удаляет renderer из area .

С: 3.0

gtk_cell_area_has_renderer ()

gboolean
gtk_cell_area_has_renderer (GtkCellArea *area,
                            GtkCellRenderer *renderer);

Проверяет, содержит ли area renderer .

С: 3.0

gtk_cell_area_foreach ()

void
gtk_cell_area_foreach (GtkCellArea *area,
                       GtkCellCallback callback,
                       gpointer callback_data);

Вызывает callback для каждого GtkCellRenderer в area .

С: 3.0

gtk_cell_area_foreach_alloc ()

void
gtk_cell_area_foreach_alloc (GtkCellArea *area,
                             GtkCellAreaContext *context,
                             GtkWidget *widget,
                             const GdkRectangle *cell_area,
                             const GdkRectangle *background_area,
                             GtkCellAllocCallback callback,
                             gpointer callback_data);

Вызывает callback для каждого GtkCellRenderer в area с выделенной областью внутри cell_area .

Since: 3.0

gtk_cell_area_event ()

gint
gtk_cell_area_event (GtkCellArea *area,
                     GtkCellAreaContext *context,
                     GtkWidget *widget,
                     GdkEvent *event,
                     const GdkRectangle *cell_area,
                     GtkCellRendererState flags);

Делегирует обработку событий GtkCellArea.

Since: 3.0

gtk_cell_area_render ()

void
gtk_cell_area_render (GtkCellArea *area,
                      GtkCellAreaContext *context,
                      GtkWidget *widget,
                      cairo_t *cr,
                      const GdkRectangle *background_area,
                      const GdkRectangle *cell_area,
                      GtkCellRendererState flags,
                      gboolean paint_focus);

Отображает ячейки area в соответствии с макетом area на widget в заданных координатах.

Since: 3.0

gtk_cell_area_get_cell_allocation ()

void
gtk_cell_area_get_cell_allocation (GtkCellArea *area,
                                   GtkCellAreaContext *context,
                                   GtkWidget *widget,
                                   GtkCellRenderer *renderer,
                                   const GdkRectangle *cell_area,
                                   GdkRectangle *allocation);

Вычисляет выделение renderer внутри area, если area было бы отрисовано в cell_area .

Since: 3.0

gtk_cell_area_get_cell_at_position ()

GtkCellRenderer *
gtk_cell_area_get_cell_at_position (GtkCellArea *area,
                                    GtkCellAreaContext *context,
                                    GtkWidget *widget,
                                    const GdkRectangle *cell_area,
                                    gint x,
                                    gint y,
                                    GdkRectangle *alloc_area);

Получает GtkCellRenderer по координатам x и y внутри area и необязательно возвращает полное размещение ячейки внутри cell_area.

С версии: 3.0

gtk_cell_area_create_context ()

GtkCellAreaContext *
gtk_cell_area_create_context (GtkCellArea *area);

Создаёт контекст GtkCellAreaContext, который будет использоваться с area для всех целей. GtkCellAreaContext хранит информацию о геометрии строк, для которых он был создан. Важно использовать один и тот же контекст для одной и той же строки данных в любое время (то есть необходимо выполнять отрисовку и обработку событий с тем же GtkCellAreaContext, который был использован для запроса размера этих строк данных).

С версии: 3.0

gtk_cell_area_copy_context ()

GtkCellAreaContext *
gtk_cell_area_copy_context (GtkCellArea *area,
                            GtkCellAreaContext *context);

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

Например, GtkIconView создаёт все значки (строки) с одинаковой шириной и ячейки в них с одинаковым горизонтальным выравниванием. Однако каждая строка значков может иметь отдельный общий размер по высоте. GtkIconView использует это для запроса высот каждой строки на основе контекста, который уже был использован для запроса всех ширин строк, которые должны быть отображены.

С версии: 3.0

gtk_cell_area_get_request_mode ()

GtkSizeRequestMode
gtk_cell_area_get_request_mode (GtkCellArea *area);

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

С версии: 3.0

gtk_cell_area_get_preferred_width ()

void
gtk_cell_area_get_preferred_width (GtkCellArea *area,
                                   GtkCellAreaContext *context,
                                   GtkWidget *widget,
                                   gint *minimum_width,
                                   gint *natural_width);

Получает минимальную и естественную ширину области ячеек.

area будет хранить некоторую геометрическую информацию в context по ходу; при запросе размеров по произвольному количеству строк, неважно проверять minimum_width и natural_width этого вызова, но нужно обратиться к gtk_cell_area_context_get_preferred_width() после серии запросов.

С версии: 3.0

gtk_cell_area_get_preferred_height_for_width ()

void
gtk_cell_area_get_preferred_height_for_width
                               (GtkCellArea *area,
                                GtkCellAreaContext *context,
                                GtkWidget *widget,
                                gint width,
                                gint *minimum_height,
                                gint *natural_height);

Получает минимальную и естественную высоту области ячейки, если ей будет задана указанная width.

area хранит некоторую геометрическую информацию в context по ходу выполнения вызова gtk_cell_area_get_preferred_width(). Важно выполнить серию запросов gtk_cell_area_get_preferred_width() с context в первую очередь, а затем вызвать gtk_cell_area_get_preferred_height_for_width() для каждой области ячейки индивидуально, чтобы получить высоту для ширины каждой полностью запрошенной строки.

Если в какой-то момент ширина одной строки изменяется, необходимо снова запросить её с помощью gtk_cell_area_get_preferred_width(), а затем снова проверить полную ширину запрошенных строк с помощью gtk_cell_area_context_get_preferred_width().

С: 3.0

gtk_cell_area_get_preferred_height ()

void
gtk_cell_area_get_preferred_height (GtkCellArea *area,
                                    GtkCellAreaContext *context,
                                    GtkWidget *widget,
                                    gint *minimum_height,
                                    gint *natural_height);

Получает начальную минимальную и естественную высоту области ячейки.

area будет хранить некоторую геометрическую информацию в context по ходу выполнения; при запросе размеров через произвольное количество строк, проверка minimum_height и natural_height этого вызова не важна, а следует обратиться к gtk_cell_area_context_get_preferred_height() после серии запросов.

С: 3.0

gtk_cell_area_get_preferred_width_for_height ()

void
gtk_cell_area_get_preferred_width_for_height
                               (GtkCellArea *area,
                                GtkCellAreaContext *context,
                                GtkWidget *widget,
                                gint height,
                                gint *minimum_width,
                                gint *natural_width);

Получает минимальную и естественную ширину области ячейки, если ей будет задана указанная height.

area хранит некоторую геометрическую информацию в context по ходу выполнения вызова gtk_cell_area_get_preferred_height(). Важно выполнить серию запросов gtk_cell_area_get_preferred_height() с context в первую очередь, а затем вызвать gtk_cell_area_get_preferred_width_for_height() для каждой области ячейки индивидуально, чтобы получить высоту для ширины каждой полностью запрошенной строки.

Если в какой-то момент высота одной строки изменяется, необходимо снова запросить её с помощью gtk_cell_area_get_preferred_height(), а затем снова проверить полную высоту запрошенных строк с помощью gtk_cell_area_context_get_preferred_height().

С: 3.0

gtk_cell_area_get_current_path_string ()

const gchar *
gtk_cell_area_get_current_path_string (GtkCellArea *area);

Получает строку текущего GtkTreePath для текущей применённой GtkTreeIter. Она неявно обновляется при вызове gtk_cell_area_apply_attributes() и может использоваться для взаимодействия с рендерерами из подклассов GtkCellArea.

С: 3.0

gtk_cell_area_apply_attributes ()

void
gtk_cell_area_apply_attributes (GtkCellArea *area,
                                GtkTreeModel *tree_model,
                                GtkTreeIter *iter,
                                gboolean is_expander,
                                gboolean is_expanded);

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

С: 3.0

gtk_cell_area_attribute_connect ()

void
gtk_cell_area_attribute_connect (GtkCellArea *area,
                                 GtkCellRenderer *renderer,
                                 const gchar *attribute,
                                 gint column);

Подключает attribute для применения значений из column для используемого GtkTreeModel.

С: 3.0

gtk_cell_area_attribute_disconnect ()

void
gtk_cell_area_attribute_disconnect (GtkCellArea *area,
                                    GtkCellRenderer *renderer,
                                    const gchar *attribute);

Отключает attribute для renderer в area, чтобы атрибут больше не обновлялся значениями из модели.

С: 3.0

gtk_cell_area_attribute_get_column ()

gint
gtk_cell_area_attribute_get_column (GtkCellArea *area,
                                    GtkCellRenderer *renderer,
                                    const gchar *attribute);

Возвращает столбец модели, к которому сопоставлен атрибут, или -1, если атрибут не сопоставлен.

С: 3.14

gtk_cell_area_class_install_cell_property ()

void
gtk_cell_area_class_install_cell_property
                               (GtkCellAreaClass *aclass,
                                guint property_id,
                                GParamSpec *pspec);

Устанавливает свойство ячейки в классе области ячеек.

С: 3.0

gtk_cell_area_class_find_cell_property ()

GParamSpec *
gtk_cell_area_class_find_cell_property
                               (GtkCellAreaClass *aclass,
                                const gchar *property_name);

Ищет свойство ячейки класса области ячеек по имени.

С: 3.0

gtk_cell_area_class_list_cell_properties ()

GParamSpec **
gtk_cell_area_class_list_cell_properties
                               (GtkCellAreaClass *aclass,
                                guint *n_properties);

Возвращает все свойства ячейки класса области ячеек.

С: 3.0

gtk_cell_area_add_with_properties ()

void
gtk_cell_area_add_with_properties (GtkCellArea *area,
                                   GtkCellRenderer *renderer,
                                   const gchar *first_prop_name,
                                   ...);

Добавляет renderer в area, одновременно задавая свойства ячейки. Подробнее см. gtk_cell_area_add() и gtk_cell_area_cell_set().

С: 3.0

gtk_cell_area_cell_set ()

void
gtk_cell_area_cell_set (GtkCellArea *area,
                        GtkCellRenderer *renderer,
                        const gchar *first_prop_name,
                        ...);

Устанавливает одно или несколько свойств ячейки для cell в area.

С: 3.0

gtk_cell_area_cell_get ()

void
gtk_cell_area_cell_get (GtkCellArea *area,
                        GtkCellRenderer *renderer,
                        const gchar *first_prop_name,
                        ...);

Получает значения одного или нескольких свойств ячейки для renderer в area.

С: 3.0

gtk_cell_area_cell_set_valist ()

void
gtk_cell_area_cell_set_valist (GtkCellArea *area,
                               GtkCellRenderer *renderer,
                               const gchar *first_property_name,
                               va_list var_args);

Устанавливает одно или несколько свойств ячейки для renderer в area.

С: 3.0

gtk_cell_area_cell_get_valist ()

void
gtk_cell_area_cell_get_valist (GtkCellArea *area,
                               GtkCellRenderer *renderer,
                               const gchar *first_property_name,
                               va_list var_args);

Получает значения одного или нескольких свойств ячейки для renderer в area.

С: 3.0

gtk_cell_area_cell_set_property ()

void
gtk_cell_area_cell_set_property (GtkCellArea *area,
                                 GtkCellRenderer *renderer,
                                 const gchar *property_name,
                                 const GValue *value);

Устанавливает свойство ячейки для renderer в area .

С момента: 3.0

gtk_cell_area_cell_get_property ()

void
gtk_cell_area_cell_get_property (GtkCellArea *area,
                                 GtkCellRenderer *renderer,
                                 const gchar *property_name,
                                 GValue *value);

Получает значение свойства ячейки для renderer в area .

С момента: 3.0

gtk_cell_area_is_activatable ()

gboolean
gtk_cell_area_is_activatable (GtkCellArea *area);

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

С момента: 3.0

gtk_cell_area_activate ()

gboolean
gtk_cell_area_activate (GtkCellArea *area,
                        GtkCellAreaContext *context,
                        GtkWidget *widget,
                        const GdkRectangle *cell_area,
                        GtkCellRendererState flags,
                        gboolean edit_only);

Активирует area, обычно активируя текущую ячейку с фокусом, однако некоторые подклассы, которые встраивают виджеты в область, также могут активировать виджет, если у него в данный момент фокус.

С момента: 3.0

gtk_cell_area_focus ()

gboolean
gtk_cell_area_focus (GtkCellArea *area,
                     GtkDirectionType direction);

Должно вызываться владельцем area виджета макета, когда фокус должен быть передан area, или перемещен внутри area для заданных direction и данных строки.

Реализации классов GtkCellArea должны реализовывать этот метод, чтобы получать и навигацию по фокусу своим способом, специфичным для того, как они размещают ячейки.

С момента: 3.0

gtk_cell_area_set_focus_cell ()

void
gtk_cell_area_set_focus_cell (GtkCellArea *area,
                              GtkCellRenderer *renderer);

Явно устанавливает текущую ячейку с фокусом на renderer .

Обычно вызывается реализациями GtkCellAreaClass.focus() или GtkCellAreaClass.event(), но также может использоваться для реализации функций, таких как gtk_tree_view_set_cursor_on_cell().

С момента: 3.0

gtk_cell_area_get_focus_cell ()

GtkCellRenderer *
gtk_cell_area_get_focus_cell (GtkCellArea *area);

Возвращает текущую ячейку с фокусом для area

С момента: 3.0

gtk_cell_area_add_focus_sibling ()

void
gtk_cell_area_add_focus_sibling (GtkCellArea *area,
                                 GtkCellRenderer *renderer,
                                 GtkCellRenderer *sibling);

Добавляет sibling в область фокусировки renderer. Фокус будет нарисован вокруг renderer и всех его соседей, если renderer может получить фокус для данного ряда.

События, обрабатываемые фокусными соседями, также могут активировать заданный фокусируемый renderer .

С: 3.0

gtk_cell_area_remove_focus_sibling ()

void
gtk_cell_area_remove_focus_sibling (GtkCellArea *area,
                                    GtkCellRenderer *renderer,
                                    GtkCellRenderer *sibling);

Удаляет sibling из списка фокусных соседей renderer (см. gtk_cell_area_add_focus_sibling()).

С: 3.0

gtk_cell_area_is_focus_sibling ()

gboolean
gtk_cell_area_is_focus_sibling (GtkCellArea *area,
                                GtkCellRenderer *renderer,
                                GtkCellRenderer *sibling);

Возвращает, является ли sibling одним из фокусных соседей renderer (см. gtk_cell_area_add_focus_sibling()).

С: 3.0

gtk_cell_area_get_focus_siblings ()

const GList *
gtk_cell_area_get_focus_siblings (GtkCellArea *area,
                                  GtkCellRenderer *renderer);

Получает фокусные соседние ячейки-рендеры для renderer .

С: 3.0

gtk_cell_area_get_focus_from_sibling ()

GtkCellRenderer *
gtk_cell_area_get_focus_from_sibling (GtkCellArea *area,
                                      GtkCellRenderer *renderer);

Возвращает GtkCellRenderer, который ожидается быть фокусируемым, для которого renderer является, или может быть, соседом.

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

С: 3.0

gtk_cell_area_get_edited_cell ()

GtkCellRenderer *
gtk_cell_area_get_edited_cell (GtkCellArea *area);

Возвращает GtkCellRenderer в area, который в данный момент редактируется.

С: 3.0

gtk_cell_area_get_edit_widget ()

GtkCellEditable *
gtk_cell_area_get_edit_widget (GtkCellArea *area);

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

С: 3.0

gtk_cell_area_activate_cell ()

gboolean
gtk_cell_area_activate_cell (GtkCellArea *area,
                             GtkWidget *widget,
                             GtkCellRenderer *renderer,
                             GdkEvent *event,
                             const GdkRectangle *cell_area,
                             GtkCellRendererState flags);

Это используется подклассами GtkCellArea при обработке событий для активации ячеек; базовый класс GtkCellArea активирует ячейки для событий клавиатуры бесплатно в своей собственной реализации GtkCellArea->activate().

Since: 3.0

gtk_cell_area_stop_editing ()

void
gtk_cell_area_stop_editing (GtkCellArea *area,
                            gboolean canceled);

Явно останавливает редактирование текущей ячейки.

Если canceled имеет значение TRUE, текущий редактируемый элемент рендеринга сгенерирует сигнал ::editing-canceled, в противном случае будет сгенерирован сигнал ::editing-done на текущем элементе редактирования.

См. gtk_cell_area_get_edited_cell() и gtk_cell_area_get_edit_widget().

Since: 3.0

gtk_cell_area_inner_cell_area ()

void
gtk_cell_area_inner_cell_area (GtkCellArea *area,
                               GtkWidget *widget,
                               const GdkRectangle *cell_area,
                               GdkRectangle *inner_area);

Это вспомогательная функция для реализации GtkCellArea для получения внутренней области, в которой будет отображен заданный GtkCellRenderer. Она удаляет любой отступ, добавленный ранее функцией gtk_cell_area_request_renderer().

Since: 3.0

gtk_cell_area_request_renderer ()

void
gtk_cell_area_request_renderer (GtkCellArea *area,
                                GtkCellRenderer *renderer,
                                GtkOrientation orientation,
                                GtkWidget *widget,
                                gint for_size,
                                gint *minimum_size,
                                gint *natural_size);

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

Since: 3.0

struct GtkCellArea

struct GtkCellArea;