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