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 позволяет «отделить» часть окна. Это виджет-контейнер, который отображает свой дочерний виджет и ручку, которую пользователь может перетащить, чтобы отсоединить отдельное окно (окно «плавания»), содержащее дочерний виджет. В исходном расположении ручки отображается тонкая «тень». Перетащив отдельное окно обратно в исходное место, его можно повторно присоединить.

При повторном присоединении окно «тень» и окно «плавания» должны быть выровнены по одному из краёв, «краю привязки». Это либо явно указывается программистом, либо 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

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

Владелец: GtkHandleBox

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

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

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

  “handle-position”          GtkPositionType

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

Владелец: GtkHandleBox

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

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

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

  “shadow-type”              GtkShadowType

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

Владелец: GtkHandleBox

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

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

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

  “snap-edge”                GtkPositionType

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

Владелец: GtkHandleBox

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

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

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

  “snap-edge-set”            gboolean

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

Владелец: GtkHandleBox

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

Значение по умолчанию: 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	данные пользователя, заданные при подключении обработчика сигнала.

Флаги: Run First

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

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

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

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

GtkHandleBox устарел.

Параметры

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

Флаги: Run First

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/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”`