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

Since: 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() после серии запросов.

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

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

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

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

Since: 3.0

gtk_cell_area_get_focus_siblings ()

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

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

Since: 3.0

gtk_cell_area_get_focus_from_sibling ()

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

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

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

Since: 3.0

gtk_cell_area_get_edited_cell ()

GtkCellRenderer *
gtk_cell_area_get_edited_cell (GtkCellArea *area);

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

Since: 3.0

gtk_cell_area_get_edit_widget ()

GtkCellEditable *
gtk_cell_area_get_edit_widget (GtkCellArea *area);

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

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

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

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

С: 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() во время отрисовки и обработки событий, так как эта функция добавит отступы вокруг ячейки для отрисовки фокуса.

С: 3.0

struct GtkCellArea

struct GtkCellArea;