GtkHandleBox

GtkHandleBox — виджет для отсоединяемых частей окна

Функции

GtkWidget *	gtk_handle_box_new ()
void	gtk_handle_box_set_shadow_type ()
void	gtk_handle_box_set_handle_position ()
void	gtk_handle_box_set_snap_edge ()
GtkPositionType	gtk_handle_box_get_handle_position ()
GtkShadowType	gtk_handle_box_get_shadow_type ()
GtkPositionType	gtk_handle_box_get_snap_edge ()
gboolean	gtk_handle_box_get_child_detached ()

Свойства

gboolean	child-detached	Чтение
GtkPositionType	handle-position	Чтение / Запись
GtkShadowType	shadow-type	Чтение / Запись
GtkPositionType	snap-edge	Чтение / Запись
gboolean	snap-edge-set	Чтение / Запись

Сигналы

void	child-attached	Выполнить сначала
void	child-detached	Выполнить сначала

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

struct	GtkHandleBox
struct	GtkHandleBoxClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkHandleBox

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

GtkHandleBox реализует AtkImplementorIface и GtkBuildable.

Включаемые файлы

#include <gtk/gtk.h>

Описание

Виджет GtkHandleBox позволяет «отделить» часть окна. Это виджет типа bin, который отображает своё дочернее виджет и ручку, которую пользователь может перетащить, чтобы отделить отдельное окно (окно «плавающее») содержащее дочерний виджет. В исходном месте handlebox рисуется тонкая «тень». Перетащив отдельное окно обратно в исходное место, его можно снова присоединить.

При повторном присоединении окно «тень» и «плавающее» окно должны быть выровнены по одному из краёв, «краю привязки». Это либо указывается программистом приложения явно, либо GTK+ выберет разумный по умолчанию, основываясь на положении ручки.

Чтобы сделать отсоединение и повторное присоединение handlebox максимально понятным для пользователя, важно установить край привязки таким образом, чтобы край привязки не перемещался при отсоединении handlebox. Например, если handlebox расположен внизу VBox, то при отсоединении handlebox нижний край размещения handlebox останется фиксированным, а высота handlebox уменьшится, поэтому край привязки следует установить на GTK_POS_BOTTOM.

GtkHandleBox устарел. Он слишком специализирован, лишен функций, которые делали бы его полезным, и, что самое главное, не подходит для современной разработки приложений. Не используйте его. Замены нет.

Функции

gtk_handle_box_new ()

GtkWidget *
gtk_handle_box_new (void);

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

GtkHandleBox устарело.

Создать новую панель-ручку.

Возвращает

новую GtkHandleBox.

gtk_handle_box_set_shadow_type ()

void
gtk_handle_box_set_shadow_type (GtkHandleBox *handle_box,
                                GtkShadowType type);

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

GtkHandleBox устарело.

Устанавливает тип тени, которая будет отображаться вокруг границы панели-ручки.

Параметры

handle_box	a GtkHandleBox
type	тип тени.

gtk_handle_box_set_handle_position ()

void
gtk_handle_box_set_handle_position (GtkHandleBox *handle_box,
                                    GtkPositionType position);

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

GtkHandleBox устарело.

Устанавливает сторону панели-ручки, где будет отображаться ручка.

Параметры

handle_box	a GtkHandleBox
position	сторона панели-ручки, где должна отображаться ручка.

gtk_handle_box_set_snap_edge ()

void
gtk_handle_box_set_snap_edge (GtkHandleBox *handle_box,
                              GtkPositionType edge);

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

GtkHandleBox устарело.

Устанавливает край привязки для панели-ручки. Край привязки — это край открепленного дочернего элемента, который должен быть выровнен с соответствующим краем «призрака», оставшегося после открепления элемента, для повторного присоединения оторванного окна. Обычно край привязки должен выбираться таким образом, чтобы он оставался в том же месте на экране, когда панель-ручка открепляется.

Если край привязки не установлен, то подходящее значение будет угадано из положения ручки. Если положение ручки — GTK_POS_RIGHT или GTK_POS_LEFT, то край привязки будет GTK_POS_TOP, в противном случае он будет GTK_POS_LEFT.

Параметры

handle_box	a GtkHandleBox
edge	край привязки или -1, чтобы сбросить значение; в этом случае GTK+ попытается угадать подходящее значение в будущем.

gtk_handle_box_get_handle_position ()

GtkPositionType
gtk_handle_box_get_handle_position (GtkHandleBox *handle_box);

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

GtkHandleBox устарело.

Получить положение ручки на панели-ручке. См. gtk_handle_box_set_handle_position().

Параметры

handle_box

a GtkHandleBox

Возвращает

текущее положение ручки.

gtk_handle_box_get_shadow_type ()

GtkShadowType
gtk_handle_box_get_shadow_type (GtkHandleBox *handle_box);

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

GtkHandleBox устарело.

Получить тип тени, отображаемой вокруг панели-ручки. См. gtk_handle_box_set_shadow_type().

Параметры

handle_box

a GtkHandleBox

Возвращает

тип тени, который в данный момент отображается вокруг панели-ручки.

gtk_handle_box_get_snap_edge ()

GtkPositionType
gtk_handle_box_get_snap_edge (GtkHandleBox *handle_box);

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

GtkHandleBox устарело.

Получить край, используемый для определения повторного присоединения панели-ручки. См. gtk_handle_box_set_snap_edge().

Параметры

handle_box

a GtkHandleBox

Возвращает

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

gtk_handle_box_get_child_detached ()

gboolean
gtk_handle_box_get_child_detached (GtkHandleBox *handle_box);

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

GtkHandleBox устарело.

Указывает, откреплён ли дочерний элемент панели-ручки.

Параметры

handle_box

a GtkHandleBox

Возвращает

TRUE, если дочерний элемент откреплён, иначе FALSE

С: 2.14

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

struct GtkHandleBox

struct GtkHandleBox;

struct GtkHandleBoxClass

struct GtkHandleBoxClass {
  GtkBinClass parent_class;

  void (*child_attached) (GtkHandleBox *handle_box,
				 GtkWidget *child);
  void (*child_detached) (GtkHandleBox *handle_box,
				 GtkWidget *child);
};

Члены

`child_attached` ()	Сигнал, генерируемый при повторном присоединении содержимого панели-ручки к основному окну. Устарело: 3.4.
`child_detached` ()	Сигнал, генерируемый при откреплении содержимого панели-ручки от основного окна. Устарело: 3.4.

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

Свойство `“child-detached”`

  “child-detached”           gboolean

Булево значение, указывающее, прикреплён ли дочерний элемент handlebox или нет.

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

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

Свойство `“handle-position”`

  “handle-position”          GtkPositionType

Положение ручки относительно виджета-потомка.

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

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

Свойство `“shadow-type”`

  “shadow-type”              GtkShadowType

Внешний вид тени, которая окружает контейнер.

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

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

Свойство `“snap-edge”`

  “snap-edge”                GtkPositionType

Сторона handlebox, которая выравнивается с точкой привязки для прикрепления handlebox.

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

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

Свойство `“snap-edge-set”`

  “snap-edge-set”            gboolean

Использовать ли значение из свойства snap_edge или значение, полученное из handle_position.

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

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

Подробное описание сигналов

Сигнал `“child-attached”`

void
user_function (GtkHandleBox *handlebox,
               GtkWidget    *widget,
               gpointer      user_data)

Этот сигнал генерируется при повторном присоединении содержимого handlebox к главному окну.

GtkHandleBox::child-attached устарел с версии 3.4 и не должен использоваться в новых кодах.

GtkHandleBox устарел.

Параметры

handlebox	объект, получивший сигнал.
widget	дочерний виджет handlebox. (этот аргумент не предоставляет дополнительной информации и присутствует только для обратной совместимости)
user_data	данные пользователя, установленные при подключении обработчика сигнала.

Флаги: Выполняется первым

Сигнал `“child-detached”`

void
user_function (GtkHandleBox *handlebox,
               GtkWidget    *widget,
               gpointer      user_data)

Этот сигнал генерируется при отсоединении содержимого handlebox от главного окна.

GtkHandleBox::child-detached устарел с версии 3.4 и не должен использоваться в новых кодах.

GtkHandleBox устарел.

Параметры

handlebox	объект, получивший сигнал.
widget	дочерний виджет handlebox. (этот аргумент не предоставляет дополнительной информации и присутствует только для обратной совместимости)
user_data	данные пользователя, установленные при подключении обработчика сигнала.

Флаги: Выполняется первым

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkHandleBox.html

GtkHandleBox

Функции

Свойства

Сигналы

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

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

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

Включаемые файлы

Описание

Функции

gtk_handle_box_new ()

Возвращает

gtk_handle_box_set_shadow_type ()

Параметры

gtk_handle_box_set_handle_position ()

Параметры

gtk_handle_box_set_snap_edge ()

Параметры

gtk_handle_box_get_handle_position ()

Параметры

Возвращает

gtk_handle_box_get_shadow_type ()

Параметры

Возвращает

gtk_handle_box_get_snap_edge ()

Параметры

Возвращает

gtk_handle_box_get_child_detached ()

Параметры

Возвращает

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

struct GtkHandleBox

struct GtkHandleBoxClass

Члены

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

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

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

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

Свойство “snap-edge”

Свойство “snap-edge-set”

Подробное описание сигналов

Сигнал “child-attached”

Параметры

Сигнал “child-detached”

Параметры

Свойство `“child-detached”`

Свойство `“handle-position”`

Свойство `“shadow-type”`

Свойство `“snap-edge”`

Свойство `“snap-edge-set”`

Сигнал `“child-attached”`

Сигнал `“child-detached”`