GtkCellAreaContext

gtk_cell_area_context_get_area ()

GtkCellArea *
gtk_cell_area_context_get_area (GtkCellAreaContext *context);

Получает GtkCellArea, для которого был создан этот context.

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

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

gtk_cell_area_context_allocate ()

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

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

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

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

gtk_cell_area_context_get_preferred_width ()

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

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

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

gtk_cell_area_context_get_preferred_height ()

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

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

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

gtk_cell_area_context_get_preferred_height_for_width ()

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

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

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

gtk_cell_area_context_get_preferred_width_for_height ()

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

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

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

gtk_cell_area_context_get_allocation ()

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

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

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

gtk_cell_area_context_push_preferred_width ()

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

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

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

gtk_cell_area_context_push_preferred_height ()

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

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

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