GtkPaned

CSS-узлы

GtkPaned имеет главный CSS-узел с именем paned и под-узел для разделителя с именем separator. Под-узлу присваивается класс стиля .wide, когда ожидается, что разделы будут широкими.

В горизонтальной ориентации узлы дочерних элементов всегда располагаются слева направо. Поэтому :first-child всегда будет выбирать самый левый дочерний элемент, независимо от направления текста.

paned
├── <child>
├── separator[.wide]
╰── <child>

gtk_paned_new ()

GtkWidget *
gtk_paned_new (GtkOrientation orientation);

Создаёт новый виджет GtkPaned.

С: 3.0

gtk_paned_add1 ()

void
gtk_paned_add1 (GtkPaned *paned,
                GtkWidget *child);

Добавляет дочерний элемент в верхнюю или левую панель с параметрами по умолчанию. Эквивалентно gtk_paned_pack1 (paned, child, FALSE, TRUE).

gtk_paned_add2 ()

void
gtk_paned_add2 (GtkPaned *paned,
                GtkWidget *child);

Добавляет дочерний элемент в нижнюю или правую панель с параметрами по умолчанию. Эквивалентно gtk_paned_pack2 (paned, child, TRUE, TRUE).

gtk_paned_pack1 ()

void
gtk_paned_pack1 (GtkPaned *paned,
                 GtkWidget *child,
                 gboolean resize,
                 gboolean shrink);

Добавляет дочерний элемент в верхнюю или левую панель.

gtk_paned_pack2 ()

void
gtk_paned_pack2 (GtkPaned *paned,
                 GtkWidget *child,
                 gboolean resize,
                 gboolean shrink);

Добавляет дочерний элемент в нижнюю или правую панель.

gtk_paned_get_child1 ()

GtkWidget *
gtk_paned_get_child1 (GtkPaned *paned);

Получает первый дочерний элемент виджета разделителя.

С: 2.4

gtk_paned_get_child2 ()

GtkWidget *
gtk_paned_get_child2 (GtkPaned *paned);

Получает второй дочерний элемент виджета разделителя.

С: 2.4

gtk_paned_set_position ()

void
gtk_paned_set_position (GtkPaned *paned,
                        gint position);

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

gtk_paned_get_position ()

gint
gtk_paned_get_position (GtkPaned *paned);

Получает положение разделителя между двумя панелями.

gtk_paned_get_handle_window ()

GdkWindow *
gtk_paned_get_handle_window (GtkPaned *paned);

Возвращает GdkWindow разделителя. Эта функция полезна при обработке событий нажатия или перемещения, позволяя отличить окно разделителя от окна дочернего элемента.

С: 2.20

gtk_paned_set_wide_handle ()

void
gtk_paned_set_wide_handle (GtkPaned *paned,
                           gboolean wide);

Устанавливает свойство «wide-handle».

С: 3.16

gtk_paned_get_wide_handle ()

gboolean
gtk_paned_get_wide_handle (GtkPaned *paned);

Получает свойство «wide-handle».

С: 3.16

struct GtkPaned

struct GtkPaned;

Свойство “max-position”

  “max-position”             gint

Максимально возможное значение свойства position. Это свойство выводится из размера и возможности изменения размера дочерних виджетов.

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

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

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

С версии: 2.4

Свойство “min-position”

  “min-position”             gint

Минимально возможное значение свойства position. Это свойство выводится из размера и возможности изменения размера дочерних виджетов.

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

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

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

С версии: 2.4

Свойство “position”

  “position”                 gint

Положение разделителя панели в пикселях (0 — полностью слева/сверху).

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

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

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

Свойство “position-set”

  “position-set”             gboolean

Истинно, если свойство Position должно использоваться.

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

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

Свойство “wide-handle”

  “wide-handle”              gboolean

Установление этого свойства в TRUE указывает, что панели необходимо обеспечить более выраженное визуальное разделение (например, потому что они разделяют два блокнота, ряды вкладок которых в противном случае сливаются визуально).

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

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

С версии: 3.16

Свойство “resize” дочернего элемента

  “resize”                   gboolean

Свойство «resize» дочернего элемента определяет, расширяется ли и сжимается ли дочерний элемент вместе с виджетом панели.

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

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

С версии: 2.4

Свойство “shrink” дочернего элемента

  “shrink”                   gboolean

Свойство «shrink» дочернего элемента определяет, может ли дочерний элемент быть меньше своего запрошенного размера.

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

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

С версии: 2.4

Свойство “handle-size” стиля

  “handle-size”              gint

Ширина ручки.

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

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

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

Сигнал “accept-position”

gboolean
user_function (GtkPaned *widget,
               gpointer  user_data)

Сигнал ::accept-position — это сигнал для привязки клавиш, который генерируется для подтверждения текущего положения ручки при перемещении ее с помощью сочетаний клавиш.

Стандартная привязка для этого сигнала — Return или Пробел.

Флаги: Действие

С версии: 2.0

Сигнал “cancel-position”

gboolean
user_function (GtkPaned *widget,
               gpointer  user_data)

Сигнал ::cancel-position — это сигнал для привязки клавиш, который генерируется для отмены перемещения положения ручки с помощью сочетаний клавиш. Положение ручки будет сброшено до значения, существовавшего до начала перемещения.

Стандартная привязка для этого сигнала — Escape.

Флаги: Действие

С версии: 2.0

Сигнал “cycle-child-focus”

gboolean
user_function (GtkPaned *widget,
               gboolean  reversed,
               gpointer  user_data)

Сигнал ::cycle-child-focus — это сигнал для привязки клавиш, который генерируется для переключения фокуса между дочерними элементами панели.

Стандартная привязка — F6.

Флаги: Действие

С версии: 2.0

Сигнал “cycle-handle-focus”

gboolean
user_function (GtkPaned *widget,
               gboolean  reversed,
               gpointer  user_data)

Сигнал ::cycle-handle-focus — это сигнал для привязки клавиш, который генерируется для переключения захвата фокуса панелью, что позволяет пользователю изменять положение ручки с помощью сочетаний клавиш.

Стандартная привязка для этого сигнала — F8.

Флаги: Действие

С версии: 2.0

Сигнал “move-handle”

gboolean
user_function (GtkPaned     *widget,
               GtkScrollType scroll_type,
               gpointer      user_data)

Сигнал ::move-handle — это сигнал для привязки клавиш, который генерируется для перемещения ручки, когда пользователь использует сочетания клавиш для ее перемещения.

Флаги: Действие

С версии: 2.0

Сигнал “toggle-handle-focus”

gboolean
user_function (GtkPaned *widget,
               gpointer  user_data)

Сигнал ::toggle-handle-focus — это сигнал для привязки клавиш, который генерируется для подтверждения текущего положения ручки и последующего переключения фокуса на следующий виджет в цепочке фокуса.

Стандартная привязка — Tab.

Флаги: Действие

С версии: 2.0