[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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

#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

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

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

Партнёры:

Хостинг: