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

Since: 3.0

gtk_cell_area_remove ()

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

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

Since: 3.0

gtk_cell_area_has_renderer ()

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

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

Since: 3.0

gtk_cell_area_foreach ()

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

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

Since: 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 по пути; при запросе размеров через произвольное количество строк, важно обращаться к gtk_cell_area_context_get_preferred_width() после серии запросов, а не к minimum_width и natural_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().

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

Структура GtkCellArea

struct GtkCellArea;