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

#include <gtk/gtk.h>


            gtkstatusbar;
gtkwidget*  gtk_statusbar_new               (void);
guint       gtk_statusbar_get_context_id    (gtkstatusbar *statusbar,
                                             const gchar *context_description);
guint       gtk_statusbar_push              (gtkstatusbar *statusbar,
                                             guint context_id,
                                             const gchar *text);
void        gtk_statusbar_pop               (gtkstatusbar *statusbar,
                                             guint context_id);
void        gtk_statusbar_remove            (gtkstatusbar *statusbar,
                                             guint context_id,
                                             guint message_id);
void        gtk_statusbar_set_has_resize_grip
                                            (gtkstatusbar *statusbar,
                                             gboolean setting);
gboolean    gtk_statusbar_get_has_resize_grip
                                            (gtkstatusbar *statusbar);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbox
                                 +----gtkhbox
                                       +----gtkstatusbar

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

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

свойства

  "has-resize-grip"      gboolean              : read / write

свойства стиля

  "shadow-type"          gtkshadowtype         : read

сигналы

"text-popped"
            void        user_function      (gtkstatusbar *statusbar,
                                            guint         context_id,
                                            gchar        *text,
                                            gpointer      user_data)       : run last
"text-pushed"
            void        user_function      (gtkstatusbar *statusbar,
                                            guint         context_id,
                                            gchar        *text,
                                            gpointer      user_data)       : run last

описание

gtkstatusbar обычно размещается в самом низу основного окна gtkwindow. она обеспечивает регулярные комментарии состояния приложения (как например состояние загрузки страницы в браузере), или может применяться для вывода небольших сообщений изменения состояния, (когда например выполнена загрузка в ftp клиенте). она так же может содержать захват для изменения размера окна (треугольная область в нижнем правом углу).

панель состояния в gtk+ поддерживает стек сообщений. сообщение которое отображается в текущий момент находится на вершине стека.

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

панель состояния создаётся с помощью gtk_statusbar_new().

сообщения добавляются с помощью gtk_statusbar_push().

сообщение из верхушки стека можно удалить используя gtk_statusbar_pop(). сообщения можно удалить из любого положения в стеке если во время добавления был зарегистрирован его message_id. это делается с помощью gtk_statusbar_remove().

детали

gtkstatusbar

typedef struct _gtkstatusbar gtkstatusbar;

содержит закрытые данные доступ к которым должен происходить из функций описанных ниже.

gtk_statusbar_new ()

gtkwidget*  gtk_statusbar_new               (void);

создаёт новую gtkstatusbar готовую к сообщениям.

gtk_statusbar_get_context_id ()

guint       gtk_statusbar_get_context_id    (gtkstatusbar *statusbar,
                                             const gchar *context_description);

возвращает новый контекстный идентификатор, учитывая описание фактического содержимого.

gtk_statusbar_push ()

guint       gtk_statusbar_push              (gtkstatusbar *statusbar,
                                             guint context_id,
                                             const gchar *text);

помещает новое сообщение в стек панели состояния.

gtk_statusbar_pop ()

void        gtk_statusbar_pop               (gtkstatusbar *statusbar,
                                             guint context_id);

удаляет верхнее сообщение из стека gtkstatusbar's.

gtk_statusbar_remove ()

void        gtk_statusbar_remove            (gtkstatusbar *statusbar,
                                             guint context_id,
                                             guint message_id);

удаляет сообщение из стека панели состояния. естественно context_id и message_id должны быть определены.

gtk_statusbar_set_has_resize_grip ()

void        gtk_statusbar_set_has_resize_grip
                                            (gtkstatusbar *statusbar,
                                             gboolean setting);

устанавливает должна ли панель состояния иметь захват для изменения размера. true по умолчанию.

gtk_statusbar_get_has_resize_grip ()

gboolean    gtk_statusbar_get_has_resize_grip
                                            (gtkstatusbar *statusbar);

определяет имеет ли панель состояния захват для изменения размера.

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

свойство "has-resize-grip"

  "has-resize-grip"      gboolean              : read / write

имеется ли захват для изменения размера окна верхнего уровня.

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

начиная с версии 2.4

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

свойство стиля "shadow-type"

  "shadow-type"          gtkshadowtype         : read

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

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

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

сигнал "text-popped"

void        user_function                  (gtkstatusbar *statusbar,
                                            guint         context_id,
                                            gchar        *text,
                                            gpointer      user_data)       : run last

издаётся каждый раз при выталкивании сообщения из стека панели состояния.

сигнал "text-pushed"

void        user_function                  (gtkstatusbar *statusbar,
                                            guint         context_id,
                                            gchar        *text,
                                            gpointer      user_data)       : run last

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

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