Spec-Zone.ru › GTK 3.24

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 Чтение / Запись
float xalign Чтение / Запись
float xscale Чтение / Запись
float yalign Чтение / Запись
float 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() вместо него

Владелец: GtkAlignment

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

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

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

С: 2.4

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

  “left-padding”             guint

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

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

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

Владелец: GtkAlignment

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

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

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

С: 2.4

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

  “right-padding”            guint

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

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

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

Владелец: GtkAlignment

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

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

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

С: 2.4

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

  “top-padding”              guint

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

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

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

Владелец: GtkAlignment

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

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

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

С: 2.4

Свойство “xalign”

  “xalign”                   float

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

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

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

Владелец: GtkAlignment

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

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

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

Свойство “xscale”

  “xscale”                   float

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

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

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

Владелец: GtkAlignment

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

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

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

Свойство “yalign”

  “yalign”                   float

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

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

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

Владелец: GtkAlignment

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

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

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

Свойство “yscale”

  “yscale”                   float

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

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

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

Владелец: GtkAlignment

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

Допустимые значения: [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.24/GtkAlignment.html

Spec-Zone.ru

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