GtkAspectFrame
GtkAspectFrame — Рамка, которая ограничивает своего потомка определённым соотношением сторон
Функции
| GtkWidget * | gtk_aspect_frame_new () |
| void | gtk_aspect_frame_set_xalign () |
| float | gtk_aspect_frame_get_xalign () |
| void | gtk_aspect_frame_set_yalign () |
| float | gtk_aspect_frame_get_yalign () |
| void | gtk_aspect_frame_set_ratio () |
| float | gtk_aspect_frame_get_ratio () |
| void | gtk_aspect_frame_set_obey_child () |
| gboolean | gtk_aspect_frame_get_obey_child () |
| void | gtk_aspect_frame_set_child () |
| GtkWidget * | gtk_aspect_frame_get_child () |
Свойства
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkAspectFrame
Реализованные интерфейсы
GtkAspectFrame реализует GtkAccessible, GtkBuildable и GtkConstraintTarget.
Инклюды
#include <gtk/gtk.h>
Описание
GtkAspectFrame полезна, когда требуется разместить виджет таким образом, чтобы он мог изменять размер, сохраняя при этом то же соотношение сторон. Например, можно нарисовать небольшой предварительный просмотр большего изображения.
Рамка может учитывать соотношение сторон дочернего виджета или использовать собственное соотношение сторон.
Узлы CSS
GtkAspectFrame использует узел CSS с именем frame.
Функции
gtk_aspect_frame_new ()
GtkWidget * gtk_aspect_frame_new (float xalign,float yalign,float ratio,gboolean obey_child);
Создаёт новый GtkAspectFrame.
Параметры
xalign | Горизонтальное выравнивание дочернего элемента в области GtkAspectFrame. Диапазон от 0.0 (выравнивание по левому краю) до 1.0 (выравнивание по правому краю). | |
yalign | Вертикальное выравнивание дочернего элемента в области GtkAspectFrame. Диапазон от 0.0 (выравнивание по верхнему краю) до 1.0 (выравнивание по нижнему краю). | |
ratio | Желаемое соотношение сторон. | |
obey_child | Если |
Возвращает
новый GtkAspectFrame.
gtk_aspect_frame_set_xalign ()
void gtk_aspect_frame_set_xalign (GtkAspectFrame *self,float xalign);
Устанавливает горизонтальное выравнивание дочернего элемента в области GtkAspectFrame.
Параметры
self | элемент GtkAspectFrame | |
xalign | горизонтальное выравнивание, от 0.0 (выравнивание по левому краю) до 1.0 (выравнивание по правому краю) |
gtk_aspect_frame_get_xalign ()
float
gtk_aspect_frame_get_xalign (GtkAspectFrame *self); Возвращает горизонтальное выравнивание дочернего элемента в области GtkAspectFrame.
Параметры
self | элемент GtkAspectFrame |
Возвращает
горизонтальное выравнивание
gtk_aspect_frame_set_yalign ()
void gtk_aspect_frame_set_yalign (GtkAspectFrame *self,float yalign);
Устанавливает вертикальное выравнивание дочернего элемента в области GtkAspectFrame.
Параметры
self | элемент GtkAspectFrame | |
yalign | вертикальное выравнивание, от 0.0 (выравнивание по верхнему краю) до 1.0 (выравнивание по нижнему краю) |
gtk_aspect_frame_get_yalign ()
float
gtk_aspect_frame_get_yalign (GtkAspectFrame *self); Возвращает вертикальное выравнивание дочернего элемента в области GtkAspectFrame.
Параметры
self | элемент GtkAspectFrame |
Возвращает
вертикальное выравнивание
gtk_aspect_frame_set_ratio ()
void gtk_aspect_frame_set_ratio (GtkAspectFrame *self,float ratio);
Устанавливает желаемое соотношение сторон дочернего элемента.
Параметры
self | элемент GtkAspectFrame | |
ratio | соотношение сторон дочернего элемента |
gtk_aspect_frame_get_ratio ()
float
gtk_aspect_frame_get_ratio (GtkAspectFrame *self); Возвращает желаемое соотношение сторон дочернего элемента, установленное с помощью gtk_aspect_frame_set_ratio().
Параметры
self | элемент GtkAspectFrame |
Возвращает
желаемое соотношение сторон
gtk_aspect_frame_set_obey_child ()
void gtk_aspect_frame_set_obey_child (GtkAspectFrame *self,gboolean obey_child);
Устанавливает, должно ли соотношение сторон запроса размера дочернего элемента переопределять установленное соотношение сторон GtkAspectFrame.
Параметры
self | элемент GtkAspectFrame | |
obey_child | Если |
gtk_aspect_frame_get_obey_child ()
gboolean
gtk_aspect_frame_get_obey_child (GtkAspectFrame *self); Возвращает, должно ли запрос размера дочернего элемента переопределять установленное соотношение сторон GtkAspectFrame.
Параметры
self | элемент GtkAspectFrame |
Возвращает
следует ли учитывать запрос размера дочернего элемента
gtk_aspect_frame_set_child ()
void gtk_aspect_frame_set_child (GtkAspectFrame *self,GtkWidget *child);
Устанавливает дочерний виджет для self.
Параметры
self | элемент GtkAspectFrame | |
child | дочерний виджет. | [allow-none] |
gtk_aspect_frame_get_child ()
GtkWidget *
gtk_aspect_frame_get_child (GtkAspectFrame *self); Получает дочерний виджет для self.
Параметры
self | элемент GtkAspectFrame |
Возвращает
дочерний виджет self@.
[nullable][transfer none]
Типы и значения
GtkAspectFrame
typedef struct _GtkAspectFrame GtkAspectFrame;
Подробные сведения о свойствах
Свойство “child”
“child” GtkWidget *
Дочерний виджет GtkAspectFrame.
Владелец: GtkAspectFrame
Флаги: Чтение / Запись
Свойство “obey-child”
“obey-child” gboolean
Определяет, должен ли GtkAspectFrame использовать соотношение сторон его дочернего виджета “child”.
Владелец: GtkAspectFrame
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “ratio”
“ratio” float
Соотношение сторон, используемое GtkAspectFrame.
Это свойство используется только если “obey-child” установлено в значение FALSE.
Владелец: GtkAspectFrame
Флаги: Чтение / Запись
Допустимые значения: [0.0001,10000]
Значение по умолчанию: 1
Свойство “xalign”
“xalign” float
Горизонтальное выравнивание дочернего виджета “child” фрейма аспекта.
Владелец: GtkAspectFrame
Флаги: Чтение / Запись
Допустимые значения: [0,1]
Значение по умолчанию: 0.5
Свойство “yalign”
“yalign” float
Вертикальное выравнивание дочернего виджета “child” фрейма аспекта.
Владелец: GtkAspectFrame
Флаги: Чтение / Запись
Допустимые значения: [0,1]
Значение по умолчанию: 0.5
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkAspectFrame.html
