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

#include <gtk/gtk.h>


            gtkhandlebox;
gtkwidget*  gtk_handle_box_new              (void);
void        gtk_handle_box_set_shadow_type  (gtkhandlebox *handle_box,
                                             gtkshadowtype type);
void        gtk_handle_box_set_handle_position

                                            (gtkhandlebox *handle_box,
                                             gtkpositiontype position);
void        gtk_handle_box_set_snap_edge    (gtkhandlebox *handle_box,
                                             gtkpositiontype edge);

gtkpositiontype gtk_handle_box_get_handle_position
                                            (gtkhandlebox *handle_box);
gtkshadowtype gtk_handle_box_get_shadow_type
                                            (gtkhandlebox *handle_box);

gtkpositiontype gtk_handle_box_get_snap_edge
                                            (gtkhandlebox *handle_box);

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

  gobject

   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbin

                                 +----gtkhandlebox

реализуемые интерфейсы

gtkhandlebox реализует atkimplementoriface.

свойства

  "handle-position"      gtkpositiontype       : read / write
  "shadow"               gtkshadowtype         : read / write
  "shadow-type"          gtkshadowtype         : read / write
  "snap-edge"            gtkpositiontype       : read / write
  "snap-edge-set"        gboolean              : read / write

сигналы

"child-attached"
            void        user_function      (gtkhandlebox *handlebox,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first
"child-detached"
            void        user_function      (gtkhandlebox *handlebox,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

описание

виджет gtkhandlebox позволяет отсоединять части окна "torn off". это контейнер с отображаемым дочерним виджетом который пользователь может перетащить отцепив от отдельного окна (плавающее окно) содержащего дочерний виджет. например вы можете отцепить меню и перетащить в удобное для вас место, а затем вернуть его на прежнее.

основное окно и перемещаемое окно должны выравниваться по одному из краёв, граница выравнивания (snap edge). это определяется непосредственно программистом приложения, или gtk+ выберет разумное значение по умолчанию для позиции маркера (область для захвата при перемещении).

для выполнения отсоединения и прикрепления обратно handlebox максимально минимизирует неудобства пользователя, важно установить границу выравнивания неподвижно при отсоединении handlebox. например, если handlebox упакован в нижний vbox, то при отсоединении handlebox, нижняя граница расположения handlebox's зафиксируется, так как высота handlebox сожмётся, поэтому граница выравнивания должна быть установлена в значение gtk_pos_bottom.

детали

gtkhandlebox

typedef struct _gtkhandlebox gtkhandlebox;

структура gtkhandlebox содержит следующие поля. (эти поля должны рассматриваться только для чтения. они никогда не должны устанавливаться приложением.)

gtk_handle_box_new ()

gtkwidget*  gtk_handle_box_new              (void);

создаёт новый контейнер обработки.

gtk_handle_box_set_shadow_type ()

void        gtk_handle_box_set_shadow_type  (gtkhandlebox *handle_box,
                                             gtkshadowtype type);

устанавливает тип тени изображаемой вокруг границ контейнера обработки.

gtk_handle_box_set_handle_position ()

void        gtk_handle_box_set_handle_position
                                            (gtkhandlebox *handle_box,
                                             gtkpositiontype position);

устанавливает сторону с которой рисуется маркер (место захвата виджета при перетаскивании).

gtk_handle_box_set_snap_edge ()

void        gtk_handle_box_set_snap_edge    (gtkhandlebox *handle_box,
                                             gtkpositiontype edge);

устанавливает границу выравнивания handlebox. граница выравнивания- это граница отсоединяемого дочернего виджета который должен быть выравнен с соответствующего края оставленного позади "ghost" когда дочерний виджет отсоединяется, для повторного прикрепления к окну. обычно, граница выравнивания должна быть выбрана так, чтобы остаться в том же самом месте экрана где handlebox отсоединён.

если граница выравнивания не установлена, то соответствующие значения предполагаются от позиции маркера. если позиция маркера gtk_pos_right или gtk_pos_left, то когда позиция границы выравнивания gtk_pos_top, иначе она будет gtk_pos_left.

gtk_handle_box_get_handle_position ()

gtkpositiontype gtk_handle_box_get_handle_position
                                            (gtkhandlebox *handle_box);

определяет позицию маркера в контейнере обработки. смотрите gtk_handle_box_set_handle_position().

gtk_handle_box_get_shadow_type ()

gtkshadowtype gtk_handle_box_get_shadow_type
                                            (gtkhandlebox *handle_box);

определяет тип тени изображаемой вокруг границ контейнера обработки. смотрите gtk_handle_box_set_shadow_type().

gtk_handle_box_get_snap_edge ()

gtkpositiontype gtk_handle_box_get_snap_edge
                                            (gtkhandlebox *handle_box);

определяет границу контейнера обработки для прикрепления. смотрите gtk_handle_box_set_snap_edge().

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

свойство "handle-position"

  "handle-position"      gtkpositiontype       : read / write

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

значение по умолчанию: gtk_pos_left

свойство "shadow"

  "shadow"               gtkshadowtype         : read / write

устаревшее свойство, вместо него используйте shadow_type.

значение по умолчанию: gtk_shadow_etched_out

свойство "shadow-type"

  "shadow-type"          gtkshadowtype         : read / write

появление тени вокруг контейнера.

значение по умолчанию: gtk_shadow_etched_out

свойство "snap-edge"

  "snap-edge"            gtkpositiontype       : read / write

сторона handlebox для закрепления.

значение по умолчанию: gtk_pos_top

свойство "snap-edge-set"

  "snap-edge-set"        gboolean              : read / write

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

значение по умолчанию: false

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

сигнал "child-attached"

void        user_function                  (gtkhandlebox *handlebox,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

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

сигнал "child-detached"

void        user_function                  (gtkhandlebox *handlebox,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

этот сигнал издаётся когда содержимое handlebox откреплено от основного окна.