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