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	Run First
void	child-detached	Run First

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

struct	GtkHandleBox
struct	GtkHandleBoxClass

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

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

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

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

Файлы заголовков

#include <gtk/gtk.h>

Описание

Виджет GtkHandleBox позволяет отсоединить часть окна. Это виджет-контейнер, который отображает свой дочерний виджет и ручку, которую пользователь может перетащить, чтобы отсоединить отдельное окно (окно «плавающее»), содержащее дочерний виджет. В исходном месте 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` ()	Сигнал, отправляемый при повторном присоединении содержимого handlebox к главному окну. Устарело: 3.4.
`child_detached` ()	Сигнал, отправляемый при откреплении содержимого handlebox от главного окна. Устарело: 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.20/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”`