Spec-Zone.ru › GTK 3.22

GtkAlignment

GtkAlignment — Виджет, управляющий выравниванием и размером своего дочернего элемента

Функции

GtkWidget * gtk_alignment_new ()
void gtk_alignment_set ()
void gtk_alignment_get_padding ()
void gtk_alignment_set_padding ()

Свойства

guint bottom-padding Чтение / Запись
guint left-padding Чтение / Запись
guint right-padding Чтение / Запись
guint top-padding Чтение / Запись
gfloat xalign Чтение / Запись
gfloat xscale Чтение / Запись
gfloat yalign Чтение / Запись
gfloat yscale Чтение / Запись

Типы и значения

struct GtkAlignment
struct GtkAlignmentClass

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkAlignment

Реализованные интерфейсы

GtkAlignment реализует AtkImplementorIface и GtkBuildable.

Файлы заголовков

#include <gtk/gtk.h>

Описание

Виджет GtkAlignment управляет выравниванием и размером своего дочернего виджета. Он имеет четыре параметра: xscale, yscale, xalign и yalign.

Параметры масштабирования используются для указания, как дочерний виджет должен расширяться, чтобы заполнить пространство, выделенное для виджета GtkAlignment. Значения могут изменяться от 0 (значит, дочерний виджет не расширяется вообще) до 1 (значит, дочерний виджет расширяется до заполнения всего доступного пространства).

Параметры выравнивания используются для размещения дочернего виджета в доступной области. Значения варьируются от 0 (верх или слева) до 1 (низ или справа). Конечно, если оба параметра масштабирования установлены в 1, параметры выравнивания не оказывают никакого влияния.

GtkAlignment устарел в версии 3.14 и не должен использоваться в новом коде. Желаемый эффект может быть достигнут с помощью свойств “halign”, “valign” и “margin” дочернего виджета.

Функции

gtk_alignment_new ()

GtkWidget *
gtk_alignment_new (gfloat xalign,
                   gfloat yalign,
                   gfloat xscale,
                   gfloat yscale);

gtk_alignment_new устарела с версии 3.14 и не должна использоваться в новом коде.

Используйте свойства выравнивания и отступов GtkWidget

Создаёт новый GtkAlignment.

Параметры

xalign

горизонтальное выравнивание дочернего виджета, от 0 (слева) до 1 (справа).

yalign

вертикальное выравнивание дочернего виджета, от 0 (сверху) до 1 (снизу).

xscale

степень горизонтального расширения дочернего виджета для заполнения свободного места, от 0 до 1. Значение 0 указывает, что дочерний виджет не должен расширяться. Значение 1 указывает, что дочерний виджет заполнит всё выделенное место для GtkAlignment.

yscale

степень вертикального расширения дочернего виджета для заполнения свободного места, от 0 до 1. Значения аналогичны xscale .

Возвращаемое значение

новый GtkAlignment

gtk_alignment_set ()

void
gtk_alignment_set (GtkAlignment *alignment,
                   gfloat xalign,
                   gfloat yalign,
                   gfloat xscale,
                   gfloat yscale);

gtk_alignment_set устарела с версии 3.14 и не должна использоваться в новом коде.

Используйте свойства выравнивания и отступов GtkWidget

Устанавливает значения GtkAlignment.

Параметры

alignment

GtkAlignment.

xalign

горизонтальное выравнивание дочернего виджета, от 0 (слева) до 1 (справа).

yalign

вертикальное выравнивание дочернего виджета, от 0 (сверху) до 1 (снизу).

xscale

степень горизонтального расширения дочернего виджета для заполнения свободного места, от 0 до 1. Значение 0 указывает, что дочерний виджет не должен расширяться. Значение 1 указывает, что дочерний виджет заполнит всё выделенное место для GtkAlignment.

yscale

степень вертикального расширения дочернего виджета для заполнения свободного места, от 0 до 1. Значения аналогичны xscale .

gtk_alignment_get_padding ()

void
gtk_alignment_get_padding (GtkAlignment *alignment,
                           guint *padding_top,
                           guint *padding_bottom,
                           guint *padding_left,
                           guint *padding_right);

gtk_alignment_get_padding устарела с версии 3.14 и не должна использоваться в новом коде.

Используйте свойства выравнивания и отступов GtkWidget

Получает отступы по сторонам виджета. См. gtk_alignment_set_padding().

Параметры

alignment

a GtkAlignment

padding_top

место для хранения отступа сверху виджета, или NULL.

[out][allow-none]

padding_bottom

место для хранения отступа снизу виджета, или NULL.

[out][allow-none]

padding_left

место для хранения отступа слева виджета, или NULL.

[out][allow-none]

padding_right

место для хранения отступа справа виджета, или NULL.

[out][allow-none]

С: 2.4

gtk_alignment_set_padding ()

void
gtk_alignment_set_padding (GtkAlignment *alignment,
                           guint padding_top,
                           guint padding_bottom,
                           guint padding_left,
                           guint padding_right);

gtk_alignment_set_padding устарела с версии 3.14 и не должна использоваться в новом коде.

Используйте свойства выравнивания и отступов GtkWidget

Устанавливает отступы по сторонам виджета. Отступы добавляют пустое пространство по сторонам виджета. Например, это можно использовать для отступа дочернего виджета вправо, добавив отступ слева.

Параметры

alignment

a GtkAlignment

padding_top

отступ сверху виджета

padding_bottom

отступ снизу виджета

padding_left

отступ слева виджета

padding_right

отступ справа виджета.

С: 2.4

Типы и значения

struct GtkAlignment

struct GtkAlignment;

struct GtkAlignmentClass

struct GtkAlignmentClass {
  GtkBinClass parent_class;
};

Члены

Подробное описание свойств

Свойство “bottom-padding”

  “bottom-padding”           guint

Отступ снизу виджета.

GtkAlignment:bottom-padding устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_margin_bottom() вместо него.

Флаги: Чтение/Запись

Допустимые значения: <= G_MAXINT

Значение по умолчанию: 0

С версии: 2.4

Свойство “left-padding”

  “left-padding”             guint

Отступ слева виджета.

GtkAlignment:left-padding устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_margin_start() вместо него.

Флаги: Чтение/Запись

Допустимые значения: <= G_MAXINT

Значение по умолчанию: 0

С версии: 2.4

Свойство “right-padding”

  “right-padding”            guint

Отступ справа виджета.

GtkAlignment:right-padding устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_margin_end() вместо него.

Флаги: Чтение/Запись

Допустимые значения: <= G_MAXINT

Значение по умолчанию: 0

С версии: 2.4

Свойство “top-padding”

  “top-padding”              guint

Отступ сверху виджета.

GtkAlignment:top-padding устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_margin_top() вместо него.

Флаги: Чтение/Запись

Допустимые значения: <= G_MAXINT

Значение по умолчанию: 0

С версии: 2.4

Свойство “xalign”

  “xalign”                   gfloat

Горизонтальное положение дочернего элемента в доступном пространстве. Значение 0.0 выровняет дочерний элемент влево (или вправо в локалях RTL); значение 1.0 выровняет дочерний элемент вправо (или влево в локалях RTL).

GtkAlignment:xalign устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_halign() для дочернего элемента вместо него.

Флаги: Чтение/Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0.5

Свойство “xscale”

  “xscale”                   gfloat

Если доступное горизонтальное пространство больше, чем необходимо, то сколько из него использовать для дочернего элемента. Значение 0.0 означает ничего; значение 1.0 означает всё.

GtkAlignment:xscale устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_hexpand() для дочернего элемента вместо него.

Флаги: Чтение/Запись

Допустимые значения: [0,1]

Значение по умолчанию: 1

Свойство “yalign”

  “yalign”                   gfloat

Вертикальное положение дочернего элемента в доступном пространстве. Значение 0.0 выровняет дочерний элемент по верху; значение 1.0 выровняет дочерний элемент по низу.

GtkAlignment:yalign устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_valign() для дочернего элемента вместо него.

Флаги: Чтение/Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0.5

Свойство “yscale”

  “yscale”                   gfloat

Если доступное вертикальное пространство больше, чем необходимо, то сколько из него использовать для дочернего элемента. Значение 0.0 означает ничего; значение 1.0 означает всё.

GtkAlignment:yscale устарело начиная с версии 3.14 и не должно использоваться в новом коде.

Используйте gtk_widget_set_vexpand() для дочернего элемента вместо него.

Флаги: Чтение/Запись

Допустимые значения: [0,1]

Значение по умолчанию: 1

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkAlignment.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API