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

#include <gtk/gtk.h>


            gtklayout;
gtkwidget*  gtk_layout_new                  (gtkadjustment *hadjustment,
                                             gtkadjustment *vadjustment);
void        gtk_layout_put                  (gtklayout *layout,
                                             gtkwidget *child_widget,
                                             gint x,
                                             gint y);
void        gtk_layout_move                 (gtklayout *layout,
                                             gtkwidget *child_widget,
                                             gint x,
                                             gint y);
void        gtk_layout_set_size             (gtklayout *layout,
                                             guint width,
                                             guint height);
void        gtk_layout_get_size             (gtklayout *layout,
                                             guint *width,
                                             guint *height);
void        gtk_layout_freeze               (gtklayout *layout);
void        gtk_layout_thaw                 (gtklayout *layout);
gtkadjustment* gtk_layout_get_hadjustment   (gtklayout *layout);
gtkadjustment* gtk_layout_get_vadjustment   (gtklayout *layout);
void        gtk_layout_set_hadjustment      (gtklayout *layout,
                                             gtkadjustment *adjustment);
void        gtk_layout_set_vadjustment      (gtklayout *layout,
                                             gtkadjustment *adjustment);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtklayout

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

gtklayout осуществляет atkimplementoriface.

свойства

  "hadjustment"          gtkadjustment         : read / write
  "height"               guint                 : read / write
  "vadjustment"          gtkadjustment         : read / write
  "width"                guint                 : read / write

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

  "x"                    gint                  : read / write
  "y"                    gint                  : read / write

сигналы

"set-scroll-adjustments"
            void        user_function      (gtklayout     *layout,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last / action

описание

gtklayout подобен gtkdrawingarea в котором он "blank slate" и ничего не делает, а создаёт пустой фон по умолчанию. он отличается изначальной поддержкой прокрутки (вы можете добавить его для gtkscrolledwindow), и он может содержать дочерние виджеты, так как является gtkcontainer. однако если вы просто рисуете, gtkdrawingarea является лучшим выбором, так как он имеет меньше накладных расходов.

когда обрабатывается выставленные сигналы на gtklayout, вы должны нарисовать gtk_layout (layout)->bin_window, а не gtk_widget (layout)->window, так как вы должны делать для области рисования.

детали

gtklayout

typedef struct {
  gdkwindow *bin_window;
} gtklayout;

gtk_layout_new ()

gtkwidget*  gtk_layout_new                  (gtkadjustment *hadjustment,
                                             gtkadjustment *vadjustment);

создаёт новый gtklayout. если вы не имеете определённых настроек, а хотите макет использовать для прокрутки, поместите null для hadjustment и vadjustment.

gtk_layout_put ()

void        gtk_layout_put                  (gtklayout *layout,
                                             gtkwidget *child_widget,
                                             gint x,
                                             gint y);

добавляет child_widget для layout, в позиции (x,y). layout становится новым родительским контейнером для child_widget.

gtk_layout_move ()

void        gtk_layout_move                 (gtklayout *layout,
                                             gtkwidget *child_widget,
                                             gint x,
                                             gint y);

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

gtk_layout_set_size ()

void        gtk_layout_set_size             (gtklayout *layout,
                                             guint width,
                                             guint height);

устанавливает размер прокручиваемой области для размещения.

gtk_layout_get_size ()

void        gtk_layout_get_size             (gtklayout *layout,
                                             guint *width,
                                             guint *height);

получает размер установленный для размещения, и определяет полную протяжённость размещаемой прокручиваемой области. смотрите gtk_layout_set_size().

gtk_layout_freeze ()

void        gtk_layout_freeze               (gtklayout *layout);

внимание

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

эта функция устарела, и не имеет никакой пользы.

gtk_layout_thaw ()

void        gtk_layout_thaw                 (gtklayout *layout);

внимание

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

эта функция устарела, и не имеет никакой пользы.

gtk_layout_get_hadjustment ()

gtkadjustment* gtk_layout_get_hadjustment   (gtklayout *layout);

эту функцию нужно вызывать только после помещения области расположения в gtkscrolledwindow или иначе сконфигурировать для прокрутки. она возвращает gtkadjustment используемый для взаимодействия между горизонтальной полосой прокрутки и layout.

смотрите gtkscrolledwindow, gtkscrollbar, gtkadjustment для деталей.

gtk_layout_get_vadjustment ()

gtkadjustment* gtk_layout_get_vadjustment   (gtklayout *layout);

эту функцию нужно вызывать только после помещения области расположения в gtkscrolledwindow или иначе сконфигурировать для прокрутки. она возвращает gtkadjustment используемый для взаимодействия между вертикальной полосой прокрутки и layout.

смотрите gtkscrolledwindow, gtkscrollbar, gtkadjustment для деталей.

gtk_layout_set_hadjustment ()

void        gtk_layout_set_hadjustment      (gtklayout *layout,
                                             gtkadjustment *adjustment);

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

смотрите gtkscrolledwindow, gtkscrollbar, gtkadjustment для деталей.

gtk_layout_set_vadjustment ()

void        gtk_layout_set_vadjustment      (gtklayout *layout,
                                             gtkadjustment *adjustment);

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

смотрите gtkscrolledwindow, gtkscrollbar, gtkadjustment для деталей.

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

свойство "hadjustment"

  "hadjustment"          gtkadjustment         : read / write

gtkadjustment для горизонтальной позиции.

свойство "height"

  "height"               guint                 : read / write

высота размещения.

допустимые значения: <= g_maxint

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

свойство "vadjustment"

  "vadjustment"          gtkadjustment         : read / write

gtkadjustment для вертикальной позиции.

свойство "width"

  "width"                guint                 : read / write

ширина размещения.

допустимые значения: <= g_maxint

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

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

дочерние свойство "x"

  "x"                    gint                  : read / write

x позиция дочернего виджета.

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

дочерние свойство "y"

  "y"                    gint                  : read / write

y позиция дочернего виджета.

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

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

сигнал "set-scroll-adjustments"

void        user_function                  (gtklayout     *layout,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last / action

смотрите также

gtkdrawingarea, gtkscrolledwindow