Spec-Zone.ru › GTK 4.0

GtkRevealer

GtkRevealer — Скрытие и показ с анимацией

Функции

GtkWidget * gtk_revealer_new ()
GtkWidget * gtk_revealer_get_child ()
void gtk_revealer_set_child ()
gboolean gtk_revealer_get_reveal_child ()
void gtk_revealer_set_reveal_child ()
gboolean gtk_revealer_get_child_revealed ()
guint gtk_revealer_get_transition_duration ()
void gtk_revealer_set_transition_duration ()
GtkRevealerTransitionType gtk_revealer_get_transition_type ()
void gtk_revealer_set_transition_type ()

Свойства

GtkWidget * child Чтение / Запись
gboolean child-revealed Чтение
gboolean reveal-child Чтение / Запись / Создание
guint transition-duration Чтение / Запись / Создание
GtkRevealerTransitionType transition-type Чтение / Запись / Создание

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

GtkRevealer
перечисление GtkRevealerTransitionType

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkRevealer

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

GtkRevealer реализует GtkAccessible, GtkBuildable и GtkConstraintTarget.

Включения

#include <gtk/gtk.h>

Описание

Виджет GtkRevealer — это контейнер, который анимирует переход своего дочернего элемента от невидимого к видимому.

Стиль перехода можно контролировать с помощью gtk_revealer_set_transition_type().

Эти анимации учитывают настройку “gtk-enable-animations”.

CSS-узлы

GtkRevealer имеет один CSS-узел с именем revealer. При стилизации GtkRevealer с помощью CSS, помните, что он только скрывает свое содержимое, а не себя. Это означает, что применённые отступы, поля и рамки будут видны даже когда свойство “reveal-child” установлено в FALSE.

Доступность

GtkRevealer использует роль GTK_ACCESSIBLE_ROLE_GROUP.

Дочерний элемент GtkRevealer, если он задан, всегда доступен в дереве доступности, независимо от состояния виджета revealer.

Функции

gtk_revealer_new ()

GtkWidget *
gtk_revealer_new (void);

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

Возвращает

новый созданный GtkRevealer

gtk_revealer_get_child ()

GtkWidget *
gtk_revealer_get_child (GtkRevealer *revealer);

Получает дочерний виджет revealer.

Параметры

revealer

a GtkRevealer

Возвращает

дочерний виджет revealer.

[nullable][transfer none]

gtk_revealer_set_child ()

void
gtk_revealer_set_child (GtkRevealer *revealer,
                        GtkWidget *child);

Устанавливает дочерний виджет revealer.

Параметры

revealer

a GtkRevealer

child

дочерний виджет.

[allow-none]

gtk_revealer_get_reveal_child ()

gboolean
gtk_revealer_get_reveal_child (GtkRevealer *revealer);

Возвращает, раскрыт ли в данный момент дочерний виджет. См. gtk_revealer_set_reveal_child().

Эта функция возвращает TRUE как только началось переключение в состояние раскрытия. Чтобы узнать, полностью ли раскрыт дочерний виджет (т.е. завершено ли переключение), используйте gtk_revealer_get_child_revealed().

Параметры

revealer

a GtkRevealer

Возвращает

TRUE , если дочерний виджет раскрыт.

gtk_revealer_set_reveal_child ()

void
gtk_revealer_set_reveal_child (GtkRevealer *revealer,
                               gboolean reveal_child);

Указывает GtkRevealer раскрыть или скрыть свой дочерний виджет.

Переключение будет анимировано с текущим типом перехода revealer .

Параметры

revealer

a GtkRevealer

reveal_child

TRUE для раскрытия дочернего виджета

gtk_revealer_get_child_revealed ()

gboolean
gtk_revealer_get_child_revealed (GtkRevealer *revealer);

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

Параметры

revealer

a GtkRevealer

Возвращает

TRUE , если дочерний виджет полностью раскрыт

gtk_revealer_get_transition_duration ()

guint
gtk_revealer_get_transition_duration (GtkRevealer *revealer);

Возвращает длительность (в миллисекундах) переходов.

Параметры

revealer

a GtkRevealer

Возвращает

длительность перехода

gtk_revealer_set_transition_duration ()

void
gtk_revealer_set_transition_duration (GtkRevealer *revealer,
                                      guint duration);

Устанавливает длительность переходов.

Параметры

revealer

a GtkRevealer

duration

новая длительность в миллисекундах

gtk_revealer_get_transition_type ()

GtkRevealerTransitionType
gtk_revealer_get_transition_type (GtkRevealer *revealer);

Получает тип анимации, который будет использован для переходов в revealer.

Параметры

revealer

a GtkRevealer

Возвращает

текущий тип перехода revealer

gtk_revealer_set_transition_type ()

void
gtk_revealer_set_transition_type (GtkRevealer *revealer,
                                  GtkRevealerTransitionType transition);

Устанавливает тип анимации, который будет использован для переходов в revealer. Доступные типы включают различные виды затемнения и сдвига.

Параметры

revealer

a GtkRevealer

transition

новый тип перехода

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

GtkRevealer

typedef struct _GtkRevealer GtkRevealer;

Перечисление GtkRevealerTransitionType

Эти значения перечисления описывают возможные переходы при показе или скрытии дочернего виджета виджета GtkRevealer.

Элементы

GTK_REVEALER_TRANSITION_TYPE_NONE

Без перехода

GTK_REVEALER_TRANSITION_TYPE_CROSSFADE

Переход с затемнением

GTK_REVEALER_TRANSITION_TYPE_SLIDE_RIGHT

Переход со сдвигом слева

GTK_REVEALER_TRANSITION_TYPE_SLIDE_LEFT

Переход со сдвигом справа

GTK_REVEALER_TRANSITION_TYPE_SLIDE_UP

Переход со сдвигом снизу

GTK_REVEALER_TRANSITION_TYPE_SLIDE_DOWN

Переход со сдвигом сверху

GTK_REVEALER_TRANSITION_TYPE_SWING_RIGHT

Переход с плавным движением слева

GTK_REVEALER_TRANSITION_TYPE_SWING_LEFT

Переход с плавным движением справа

GTK_REVEALER_TRANSITION_TYPE_SWING_UP

Переход с плавным движением снизу

GTK_REVEALER_TRANSITION_TYPE_SWING_DOWN

Переход с плавным движением сверху

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

Свойство “child”

  “child”                    GtkWidget *

Виджет-потомок.

Владелец: GtkRevealer

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

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

  “child-revealed”           gboolean

Состояние раскрытия потомка и достижение целевого состояния анимации.

Владелец: GtkRevealer

Флаги: Чтение

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

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

  “reveal-child”             gboolean

Флаг, указывающий, должен ли контейнер раскрыть потомок.

Владелец: GtkRevealer

Флаги: Чтение / Запись / Создание

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

Свойство “transition-duration”

  “transition-duration”      guint

Продолжительность анимации в миллисекундах.

Владелец: GtkRevealer

Флаги: Чтение / Запись / Создание

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

Свойство “transition-type”

  “transition-type”          GtkRevealerTransitionType

Тип анимации перехода.

Владелец: GtkRevealer

Флаги: Чтение / Запись / Создание

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

См. также

GtkExpander

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

Spec-Zone.ru

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