GtkCellAreaContext

gtk_cell_area_context_get_area ()

GtkCellArea *
gtk_cell_area_context_get_area (GtkCellAreaContext *context);

Возвращает GtkCellArea, для которого был создан данный context.

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

Например, во время GtkCellAreaContextClass.allocate() важно знать детали отступов ячеек, которые настроены в GtkCellArea, чтобы вычислить правильное размещение.

С: 3.0

gtk_cell_area_context_allocate ()

void
gtk_cell_area_context_allocate (GtkCellAreaContext *context,
                                gint width,
                                gint height);

Выделяет ширину и/или высоту для всех строк, которые должны быть отрисованы с помощью context .

Обычно выделение выполняется только по горизонтали или иногда по вертикали, так как группа строк обычно отображается друг под другом или рядом и разделяет либо одинаковую ширину, либо одинаковую высоту. Иногда они выделяются как по горизонтали, так и по вертикали, создавая однородный эффект строк. Это обычно имеет место для GtkTreeView, когда включен режим “fixed-height-mode”.

С 3.0

gtk_cell_area_context_reset ()

void
gtk_cell_area_context_reset (GtkCellAreaContext *context);

Сбрасывает любые предварительно кэшированные запросы и данные выделения.

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

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

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

С 3.0

gtk_cell_area_context_get_preferred_width ()

void
gtk_cell_area_context_get_preferred_width
                               (GtkCellAreaContext *context,
                                gint *minimum_width,
                                gint *natural_width);

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

После вызова gtk_cell_area_context_reset() и/или перед запросом размера GtkCellArea возвращаемые значения равны 0.

С: 3.0

gtk_cell_area_context_get_preferred_height ()

void
gtk_cell_area_context_get_preferred_height
                               (GtkCellAreaContext *context,
                                gint *minimum_height,
                                gint *natural_height);

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

После вызова gtk_cell_area_context_reset() и/или перед запросом размера GtkCellArea возвращаемые значения равны 0.

С: 3.0

gtk_cell_area_context_get_preferred_height_for_width ()

void
gtk_cell_area_context_get_preferred_height_for_width
                               (GtkCellAreaContext *context,
                                gint width,
                                gint *minimum_height,
                                gint *natural_height);

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

После вызова gtk_cell_area_context_reset() и/или перед запросом размера GtkCellArea, возвращаемые значения равны -1.

С момента: 3.0

gtk_cell_area_context_get_preferred_width_for_height ()

void
gtk_cell_area_context_get_preferred_width_for_height
                               (GtkCellAreaContext *context,
                                gint height,
                                gint *minimum_width,
                                gint *natural_width);

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

После вызова gtk_cell_area_context_reset() и/или перед запросом размера GtkCellArea, возвращаемые значения равны -1.

С момента: 3.0

gtk_cell_area_context_get_allocation ()

void
gtk_cell_area_context_get_allocation (GtkCellAreaContext *context,
                                      gint *width,
                                      gint *height);

Получает текущий размер выделения для context .

Если контекст не был выделен по ширине или высоте, или если контекст был недавно сброшен с помощью gtk_cell_area_context_reset(), возвращаемое значение будет -1.

С момента: 3.0

gtk_cell_area_context_push_preferred_width ()

void
gtk_cell_area_context_push_preferred_width
                               (GtkCellAreaContext *context,
                                gint minimum_width,
                                gint natural_width);

Приводит к увеличению минимальной и/или естественной ширины, если новые предлагаемые размеры превышают текущую минимальную и естественную ширину.

Используется реализациями GtkCellAreaContext во время процесса запроса по серии строк GtkTreeModel, чтобы постепенно увеличивать запрашиваемую ширину над серией запросов gtk_cell_area_get_preferred_width().

С момента: 3.0

gtk_cell_area_context_push_preferred_height ()

void
gtk_cell_area_context_push_preferred_height
                               (GtkCellAreaContext *context,
                                gint minimum_height,
                                gint natural_height);

Приводит к увеличению минимальной и/или естественной высоты, если новые предлагаемые размеры превышают текущую минимальную и естественную высоту.

Используется реализациями GtkCellAreaContext во время процесса запроса по серии строк GtkTreeModel, чтобы постепенно увеличивать запрашиваемую высоту над серией запросов gtk_cell_area_get_preferred_height().

С момента: 3.0