GtkConstraintLayout

gtk_constraint_layout_new ()

GtkLayoutManager *
gtk_constraint_layout_new (void);

Создаёт новый менеджер компоновки GtkConstraintLayout.

gtk_constraint_layout_add_constraint ()

void
gtk_constraint_layout_add_constraint (GtkConstraintLayout *layout,
                                      GtkConstraint *constraint);

Добавляет GtkConstraint к менеджеру компоновки.

Свойства «source» и «target» constraint могут быть:

layout получает владение constraint после вызова этой функции.

gtk_constraint_layout_remove_constraint ()

void
gtk_constraint_layout_remove_constraint
                               (GtkConstraintLayout *layout,
                                GtkConstraint *constraint);

Удаляет constraint из менеджера компоновки, чтобы он больше не влиял на компоновку.

gtk_constraint_layout_remove_all_constraints ()

void
gtk_constraint_layout_remove_all_constraints
                               (GtkConstraintLayout *layout);

Удаляет все ограничения из менеджера компоновки.

gtk_constraint_layout_add_guide ()

void
gtk_constraint_layout_add_guide (GtkConstraintLayout *layout,
                                 GtkConstraintGuide *guide);

Добавляет ориентир к layout. Ориентир может использоваться в качестве источника или цели ограничений, как и виджет, но он не отображается.

layout получает владение guide после вызова этой функции.

gtk_constraint_layout_remove_guide ()

void
gtk_constraint_layout_remove_guide (GtkConstraintLayout *layout,
                                    GtkConstraintGuide *guide);

Удаляет guide из менеджера компоновки, чтобы он больше не влиял на компоновку.

gtk_constraint_layout_add_constraints_from_description ()

GList *
gtk_constraint_layout_add_constraints_from_description
                               (GtkConstraintLayout *layout,
                                const char * const lines[],
                                gsize n_lines,
                                int hspacing,
                                int vspacing,
                                GError **error,
                                const char *first_view,
                                ...);

Создаёт список ограничений по формальному описанию, используя компактный синтаксис описания, называемый VFL или «Visual Format Language».

Эта функция является удобной оболочкой вокруг gtk_constraint_layout_add_constraints_from_descriptionv(), используя аргументы с переменным числом параметров для заполнения карты виджет/цели.

gtk_constraint_layout_add_constraints_from_descriptionv ()

GList *
gtk_constraint_layout_add_constraints_from_descriptionv
                               (GtkConstraintLayout *layout,
                                const char * const lines[],
                                gsize n_lines,
                                int hspacing,
                                int vspacing,
                                GHashTable *views,
                                GError **error);

Создаёт список ограничений из формального описания, используя компактный синтаксис описания, называемый VFL, или «Язык визуального форматирования».

Язык визуального форматирования основан на AutoLayout от Apple VFL.

Словарь views используется для сопоставления GtkConstraintTargets со символическим именем представления внутри VFL.

Грамматика VFL:

**Примечание**: Грамматика VFL, используемая GTK, немного отличается от определённой Apple, так как она может использовать символические значения для силы ограничения вместо числовых значений; кроме того, GTK позволяет добавлять простые арифметические операции внутри предикатов.

Примеры описаний VFL:

<object class="GtkConstraintLayout">
  <constraints>
    <constraint target="button" target-attribute="start"
                relation="eq"
                source="super" source-attribute="start"
                constant="12"
                strength="required" />
    <constraint target="button" target-attribute="width"
                relation="ge"
                constant="250"
                strength="strong" />
  </constraints>
</object>

[rename-to gtk_constraint_layout_add_constraints_from_description]

gtk_constraint_layout_observe_constraints ()

GListModel *
gtk_constraint_layout_observe_constraints
                               (GtkConstraintLayout *layout);

Возвращает GListModel для отслеживания ограничений, которые являются частью layout.

Вызов этой функции включит дополнительную внутреннюю учётную запись для отслеживания ограничений и отправки сигналов в возвращаемом listmodel. Это может значительно замедлить операции.

Приложения должны изо всех сил стараться избегать вызова этой функции из-за замедления.

gtk_constraint_layout_observe_guides ()

GListModel *
gtk_constraint_layout_observe_guides (GtkConstraintLayout *layout);

Возвращает GListModel для отслеживания направляющих, которые являются частью layout.

Вызов этой функции включит дополнительную внутреннюю учётную запись для отслеживания направляющих и отправки сигналов в возвращаемом listmodel. Это может значительно замедлить операции.

Приложения должны изо всех сил стараться избегать вызова этой функции из-за замедления.