Spec-Zone.ru › GTK 3.22

GtkAspectFrame

GtkAspectFrame — Фрейм, ограничивающий своего ребёнка определённым соотношением сторон

Функции

GtkWidget * gtk_aspect_frame_new ()
void gtk_aspect_frame_set ()

Свойства

gboolean obey-child Чтение / Запись
gfloat ratio Чтение / Запись
gfloat xalign Чтение / Запись
gfloat yalign Чтение / Запись

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

struct GtkAspectFrame
struct GtkAspectFrameClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkFrame
                        ╰── GtkAspectFrame

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

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

Включенные заголовочные файлы

#include <gtk/gtk.h>

Описание

GtkAspectFrame полезен, когда необходимо разместить виджет так, чтобы он мог изменять размер, но при этом всегда сохранял то же соотношение сторон. Например, можно отрисовать небольшой превью изображения большего размера. GtkAspectFrame наследуется от GtkFrame, поэтому он может отрисовать подпись и рамку вокруг ребёнка. Фрейм будет «упакован» в размер ребёнка.

Узлы CSS

GtkAspectFrame использует узел CSS с именем frame.

Функции

gtk_aspect_frame_new ()

GtkWidget *
gtk_aspect_frame_new (const gchar *label,
                      gfloat xalign,
                      gfloat yalign,
                      gfloat ratio,
                      gboolean obey_child);

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

Параметры

label

Текст метки.

[allow-none]

xalign

Горизонтальное выравнивание ребёнка внутри размещения GtkAspectFrame. Диапазон от 0.0 (выравнивание по левому краю) до 1.0 (выравнивание по правому краю)

yalign

Вертикальное выравнивание ребёнка внутри размещения GtkAspectFrame. Диапазон от 0.0 (выравнивание по верхнему краю) до 1.0 (выравнивание по нижнему краю)

ratio

Желаемое соотношение сторон.

obey_child

Если TRUE, значение ratio игнорируется, а соотношение сторон берётся из запроса ребёнка.

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

новый GtkAspectFrame.

gtk_aspect_frame_set ()

void
gtk_aspect_frame_set (GtkAspectFrame *aspect_frame,
                      gfloat xalign,
                      gfloat yalign,
                      gfloat ratio,
                      gboolean obey_child);

Устанавливает параметры существующего GtkAspectFrame.

Параметры

aspect_frame

GtkAspectFrame

xalign

Горизонтальное выравнивание ребёнка внутри размещения GtkAspectFrame. Диапазон от 0.0 (выравнивание по левому краю) до 1.0 (выравнивание по правому краю)

yalign

Вертикальное выравнивание ребёнка внутри размещения GtkAspectFrame. Диапазон от 0.0 (выравнивание по верхнему краю) до 1.0 (выравнивание по нижнему краю)

ratio

Желаемое соотношение сторон.

obey_child

Если TRUE, значение ratio игнорируется, а соотношение сторон берётся из запроса ребёнка.

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

struct GtkAspectFrame

struct GtkAspectFrame;

struct GtkAspectFrameClass

struct GtkAspectFrameClass {
  GtkFrameClass parent_class;
};

Члены

Подробности свойств

Свойство “obey-child”

  “obey-child”               gboolean

Принудительно устанавливает соотношение сторон, соответствующее ребёнку фрейма.

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

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

Свойство “ratio”

  “ratio”                    gfloat

Соотношение сторон, если obey_child равен FALSE.

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

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

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

Свойство “xalign”

  “xalign”                   gfloat

Горизонтальное выравнивание ребёнка.

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

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

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

Свойство “yalign”

  “yalign”                   gfloat

Вертикальное выравнивание ребёнка.

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

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

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

© 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/GtkAspectFrame.html

Spec-Zone.ru

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