Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Child Properties  |  Style Properties  |  Signals

GtkPaned

GtkPaned Базовый класс для виджетов с двумя регулируемыми панелями

Краткое описание

#include <gtk/gtk.h> GtkPaned; void gtk_paned_add1 (GtkPaned *paned, GtkWidget *child); void gtk_paned_add2 (GtkPaned *paned, GtkWidget *child); #define gtk_paned_gutter_size (p,s) void gtk_paned_pack1 (GtkPaned *paned, GtkWidget *child, gboolean resize, gboolean shrink); void gtk_paned_pack2 (GtkPaned *paned, GtkWidget *child, gboolean resize, gboolean shrink); GtkWidget* gtk_paned_get_child1 (GtkPaned *paned); GtkWidget* gtk_paned_get_child2 (GtkPaned *paned); #define gtk_paned_set_gutter_size (p,s) void gtk_paned_set_position (GtkPaned *paned, gint position); gint gtk_paned_get_position (GtkPaned *paned);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkPaned +----GtkHPaned +----GtkVPaned

Осуществляемый интерфейс

GtkPaned осуществляет AtkImplementorIface.

Свойства

"max-position" gint : Read "min-position" gint : Read "position" gint : Read / Write "position-set" gboolean : Read / Write

Дочерние свойства

"resize" gboolean : Read / Write "shrink" gboolean : Read / Write

Свойство стиля

"handle-size" gint : Read

Сигналы

"accept-position" gboolean user_function (GtkPaned *paned, gpointer user_data) : Run last / Action "cancel-position" gboolean user_function (GtkPaned *paned, gpointer user_data) : Run last / Action "cycle-child-focus" gboolean user_function (GtkPaned *paned, gboolean arg1, gpointer user_data) : Run last / Action "cycle-handle-focus" gboolean user_function (GtkPaned *paned, gboolean arg1, gpointer user_data) : Run last / Action "move-handle" gboolean user_function (GtkPaned *paned, GtkScrollType arg1, gpointer user_data) : Run last / Action "toggle-handle-focus" gboolean user_function (GtkPaned *paned, gpointer user_data) : Run last / Action

Описание

GtkPaned базовый класс для виджетов с двумя панелями, регулируемыми или горизонтально (GtkHPaned) или вертикально (GtkVPaned). Дочерние виджеты добавляются на панели виджета с использованием gtk_paned_pack1() и gtk_paned_pack2(). Деление между двумя панелями устанавливается по умолчанию из запрашиваемого размера, но может быть отрегулировано пользователем.

Панельный виджет отрисовывает разделитель между двумя дочерними виджетами и небольшую область захвата с помощью которой пользователь может регулировать деление. Вокруг панелей или разделителя не создается никакого декоративного рельефа. (Поле разделителя называют жёлоб (gutter).) Часто бывает полезным поместить каждую дочернюю панель в GtkFrame с типом тени установленной в GTK_SHADOW_IN, таким образом жёлоб появляется как ребро небольшой ширины.

Каждая дочерняя панель имеет две опции, resize и shrink. Если resize истина, то когда GtkPaned изменит размер, то дочерний виджет сожмётся или расширится вместе с панельным виджетом. Если shrink истина, то дочерний виджет может быть сделан меньше чем запрашивается пользователем. Установка shrink в FALSE позволяет приложению установить минимальный размер. Если resize ложно для обоих дочерних виджетов, то это обрабатывается как истинный resize для обоих.

Приложение может устанавливать позицию ползунка, как если бы это сделал пользователь, используя вызов gtk_paned_set_position().

Пример 1. Создание панельного виджета минимального размера.

GtkWidget *hpaned = gtk_hpaned_new (); GtkWidget *frame1 = gtk_frame_new (NULL); GtkWidget *frame2 = gtk_frame_new (NULL); gtk_frame_set_shadow_type (GTK_FRAME (frame1), GTK_SHADOW_IN); gtk_frame_set_shadow_type (GTK_FRAME (frame2), GTK_SHADOW_IN); gtk_widget_set_size_request (hpaned, 200 + GTK_PANED (hpaned)->gutter_size, -1); gtk_paned_pack1 (GTK_PANED (hpaned), frame1, TRUE, FALSE); gtk_widget_set_size_request (frame1, 50, -1); gtk_paned_pack2 (GTK_PANED (hpaned), frame2, FALSE, FALSE); gtk_widget_set_size_request (frame2, 50, -1);

Детали

GtkPaned

typedef struct _GtkPaned GtkPaned;

gtk_paned_add1 ()

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

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

paned :

Панельный виджет

child :

Добавляемый виджет


gtk_paned_add2 ()

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

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

paned :

Панельный виджет

child :

Добавляемый виджет


gtk_paned_gutter_size()

#define gtk_paned_gutter_size(p,s)              (void) 0

Внимание

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

Старое имя для gtk_paned_set_gutter_size().

p :

Панельный виджет

s :

Ширина желоба в пикселах


gtk_paned_pack1 ()

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

Добавляет дочернюю панель к высшей или левой панели.

paned :

Панельный виджет

child :

Добавляемый виджет

resize :

Должен ли дочерний виджет расширяться когда панельный виджет изменяет размер.

shrink :

Может ли дочерний виджет быть меньше чем заявлено.


gtk_paned_pack2 ()

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

Добавляет панель с низу или справа панели.

paned :

Панельный виджет

child :

Добавляемый виджет

resize :

Должен ли дочерний виджет расширяться когда панельный виджет изменяет размер.

shrink :

Может ли дочерний виджет быть меньше чем заявлено.


gtk_paned_get_child1 ()

GtkWidget*  gtk_paned_get_child1            (GtkPaned *paned);

Получает первый дочерний виджет панельного виджета.

paned :

Виджет GtkPaned

Возвращает :

Первый дочерний виджет, или NULL если нет.

Начиная с версии 2.4


gtk_paned_get_child2 ()

GtkWidget*  gtk_paned_get_child2            (GtkPaned *paned);

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

paned :

Виджет GtkPaned

Возвращает :

Второй дочерний виджет, или NULL если нет.

Начиная с версии 2.4


gtk_paned_set_gutter_size()

#define gtk_paned_set_gutter_size(p,s)          (void) 0

Внимание

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

В старых версиях GTK+, эта функция использовалась для установки ширины желоба (область между двумя панелями). Теперь она не используется.

p :

Панельный виджет

s :

Ширина желоба в пикселах


gtk_paned_set_position ()

void gtk_paned_set_position (GtkPaned *paned, gint position);

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

paned :

Виджет GtkPaned

position :

Позиция разделителя в пикселах, отрицательное значение означает не установленную позицию.


gtk_paned_get_position ()

gint        gtk_paned_get_position          (GtkPaned *paned);

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

paned :

Виджет GtkPaned

Возвращает :

Позиция разделителя

Детали свойств

Свойство "max-position"

  "max-position"         gint                  : Read

Самое большое, возможное значение свойства позиции. Это свойство происходит из размера и возможности уменьшаться дочернего виджета.

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

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

Начиная с версии 2.4


Свойство "min-position"

  "min-position"         gint                  : Read

Самое маленькое, возможное значение свойства позиции. Это свойство происходит из размера и возможности уменьшаться дочернего виджета.

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

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

Начиная с версии 2.4


Свойство "position"

  "position"             gint                  : Read / Write

Позиция разделителя панелей в пикселах (0 означает весь путь left/top).

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

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


Свойство "position-set"

  "position-set"         gboolean              : Read / Write

TRUE если свойство позиции должно быть использовано.

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

Детали дочерних свойств

Дочернее свойство "resize"

  "resize"               gboolean              : Read / Write

Дочернее свойство "resize" определяет должен ли дочерний виджет расширяться и сужаться вместе с панельным виджетом.

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

Начиная с версии 2.4


Дочернее свойство "shrink"

  "shrink"               gboolean              : Read / Write

Дочернее свойство "shrink" определяет может ли дочерний виджет быть меньше чем заявленно.

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

Начиная с версии 2.4

Детали свойств стиля

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

  "handle-size"          gint                  : Read

Ширина области для регулирования.

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

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

Детали сигналов

Сигнал "accept-position"

gboolean user_function (GtkPaned *paned, gpointer user_data) : Run last / Action

paned :

объект который получает сигнал.

user_data :

пользовательские данные устанавливаемые когда подключается обработчик.

Возвращает :


Сигнал "cancel-position"

gboolean user_function (GtkPaned *paned, gpointer user_data) : Run last / Action

paned :

объект который получает сигнал.

user_data :

пользовательские данные устанавливаемые когда подключается обработчик.

Возвращает :


Сигнал "cycle-child-focus"

gboolean user_function (GtkPaned *paned, gboolean arg1, gpointer user_data) : Run last / Action

paned :

объект который получает сигнал.

arg1 :

user_data :

пользовательские данные устанавливаемые когда подключается обработчик.

Возвращает :


Сигнал "cycle-handle-focus"

gboolean user_function (GtkPaned *paned, gboolean arg1, gpointer user_data) : Run last / Action

paned :

объект который получает сигнал.

arg1 :

user_data :

пользовательские данные устанавливаемые когда подключается обработчик.

Возвращает :


Сигнал "move-handle"

gboolean user_function (GtkPaned *paned, GtkScrollType arg1, gpointer user_data) : Run last / Action

paned :

объект который получает сигнал.

arg1 :

user_data :

пользовательские данные устанавливаемые когда подключается обработчик.

Возвращает :


Сигнал "toggle-handle-focus"

gboolean user_function (GtkPaned *paned, gpointer user_data) : Run last / Action

paned :

объект который получает сигнал.

user_data :

пользовательские данные устанавливаемые когда подключается обработчик.

Возвращает :