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