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

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

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

#include <gtk/gtk.h>


            GtkExpander;
GtkWidget*  gtk_expander_new                (const gchar *label);
GtkWidget*  gtk_expander_new_with_mnemonic  (const gchar *label);
void        gtk_expander_set_expanded       (GtkExpander *expander,
                                             gboolean expanded);

gboolean    gtk_expander_get_expanded       (GtkExpander *expander);
void        gtk_expander_set_spacing        (GtkExpander *expander,
                                             gint spacing);

gint        gtk_expander_get_spacing        (GtkExpander *expander);
void        gtk_expander_set_label          (GtkExpander *expander,
                                             const gchar *label);
const gchar* gtk_expander_get_label         (GtkExpander *expander);
void        gtk_expander_set_use_underline  (GtkExpander *expander,
                                             gboolean use_underline);

gboolean    gtk_expander_get_use_underline  (GtkExpander *expander);
void        gtk_expander_set_use_markup     (GtkExpander *expander,
                                             gboolean use_markup);

gboolean    gtk_expander_get_use_markup     (GtkExpander *expander);
void        gtk_expander_set_label_widget   (GtkExpander *expander,
                                             GtkWidget *label_widget);

GtkWidget*  gtk_expander_get_label_widget   (GtkExpander *expander);

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

  GObject

   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin

                                 +----GtkExpander

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

GtkExpander осуществляет AtkImplementorIface.

Свойства

  "expanded"             gboolean              : Read / Write / Construct
  "label"                gchararray            : Read / Write / Construct
  "label-widget"         GtkWidget             : Read / Write
  "spacing"              gint                  : Read / Write
  "use-markup"           gboolean              : Read / Write / Construct
  "use-underline"        gboolean              : Read / Write / Construct

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

  "expander-size"        gint                  : Read
  "expander-spacing"     gint                  : Read

Сигналы

"activate"  void        user_function      (GtkExpander *expander,
                                            gpointer     user_data)      : Run last / Action

Описание

GtkExpander позволяет скрывать или показывать свой дочерний виджет пользователю нажимая на расширительный треугольник похожий на треугольник используемый в GtkTreeView.

Обычно расширитель используется как любой другой потомок GtkBin; вы создаёте дочерний виджет и используя gtk_container_add() добавляете его в расширитель. Когда расширитель переключается, он будет автоматически скрывать и показывать свой дочерний виджет.

Особенности использования

Есть ситуации когда вам нужно отображать и скрывать виджет расширителя самостоятельно, например когда вы хотите создать виджет вовремя расширения. В этом случае, создаётся GtkExpander но к нему не добавляется дочерний виджет. Расширительный виджет имеет expanded свойство которое может быть использовано для мониторинга состояния расширения. Вы должны отслеживать это свойство с помощь сигнала, например так:

expander = gtk_expander_new_with_mnemonic ("_More Options");
g_signal_connect (expander, "notify::expanded",
                  G_CALLBACK (expander_callback), NULL);

...

static void
expander_callback (GObject    *object,
                   GParamSpec *param_spec,
                   gpointer    user_data)
{
  GtkExpander *expander;

  expander = GTK_EXPANDER (object);

  if (gtk_expander_get_expanded (expander))
    {
      /* Показываемые или создаваемые виджеты */
    }
  else
    {
      /* Скрываемые или разрушаемые виджеты */
    }
}

    

Детали

GtkExpander

typedef struct _GtkExpander GtkExpander;

gtk_expander_new ()

GtkWidget*  gtk_expander_new                (const gchar *label);

Создаёт новый расширитель использующий label как текст метки.

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

gtk_expander_new_with_mnemonic ()

GtkWidget*  gtk_expander_new_with_mnemonic  (const gchar *label);

Создаёт новый расширитель использующий label как текст метки. Если знакам в label предшествует подчёркивание, то они подчёркиваются. Если вам нужен знак подчёркивания перед меткой, используйте '__' (двойное подчёркивание). Первый подчёркнутый знак представляет клавиатурный акселератор называемый мнемоник. Нажатие клавиши Alt и этой клавиши активизирует кнопку.

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

gtk_expander_set_expanded ()

void        gtk_expander_set_expanded       (GtkExpander *expander,
                                             gboolean expanded);

Устанавливает состояние расширителя. Установите TRUE, если вы хотите сделать дочерний виджет отображаемым, а FALSE если вы хотите сделать дочерний виджет скрытым.

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

gtk_expander_get_expanded ()

gboolean    gtk_expander_get_expanded       (GtkExpander *expander);

Запрашивает GtkExpander и возвращает текущеме состояние. Возвращается TRUE если дочерний виджет отображаем.

Смотрите gtk_expander_set_expanded().

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

gtk_expander_set_spacing ()

void        gtk_expander_set_spacing        (GtkExpander *expander,
                                             gint spacing);

Устанавливает свободное пространство expander, которое является числом пикселей между расширителем и дочерним виджетом.

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

gtk_expander_get_spacing ()

gint        gtk_expander_get_spacing        (GtkExpander *expander);

Получает значение установленное gtk_expander_set_spacing().

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

gtk_expander_set_label ()

void        gtk_expander_set_label          (GtkExpander *expander,
                                             const gchar *label);

Устанавливает текст метки расширителя равным label.

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

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

gtk_expander_get_label ()

const gchar* gtk_expander_get_label         (GtkExpander *expander);

Извлекает текст из метки расширителя, которая установлена функцией gtk_expander_set_label(). Если текст метки не установлен возвращается NULL. Это происходит при создании пустой кнопки с помощью gtk_button_new() используемой как контейнер.

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

gtk_expander_set_use_underline ()

void        gtk_expander_set_use_underline  (GtkExpander *expander,
                                             gboolean use_underline);

Если установлено TRUE, подчеркивание в тексте метки расширителя сообщает что следующий знак должен использоваться как клавиша мнемонического акселератора.

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

gtk_expander_get_use_underline ()

gboolean    gtk_expander_get_use_underline  (GtkExpander *expander);

Определяет является ли подчёркивание в метки расширителя индикатором мнемоника. Смотрите gtk_expander_set_use_underline().

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

gtk_expander_set_use_markup ()

void        gtk_expander_set_use_markup     (GtkExpander *expander,
                                             gboolean use_markup);

Устанавливает содержит ли текст метки разметку в Pango's text markup language. Смотрите gtk_label_set_markup().

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

gtk_expander_get_use_markup ()

gboolean    gtk_expander_get_use_markup     (GtkExpander *expander);

Определяет интерпретируется ли текст метки как разметка Pango text markup language. Смотрите gtk_expander_set_use_markup().

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

gtk_expander_set_label_widget ()

void        gtk_expander_set_label_widget   (GtkExpander *expander,
                                             GtkWidget *label_widget);

Устанавливает ярлык виджет для расширителя. Это виджет который будет вложен рядом со стрелкой расширителя.

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

gtk_expander_get_label_widget ()

GtkWidget*  gtk_expander_get_label_widget   (GtkExpander *expander);

Восстанавливает ярлык виджет для конструкции. Смотрите gtk_expander_set_label_widget().

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

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

Свойство "expanded"

  "expanded"             gboolean              : Read / Write / Construct

Открыт ли расширитель для отображения дочернего виджета.

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

Свойство "label"

  "label"                gchararray            : Read / Write / Construct

Текст метки расширителя.

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

Свойство "label-widget"

  "label-widget"         GtkWidget             : Read / Write

Ярлык виджет для отображения вместо обычной метки.

Свойство "spacing"

  "spacing"              gint                  : Read / Write

Промежуток между меткой и дочерним виджетом.

Допустимые значения: >= 0

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

Свойство "use-markup"

  "use-markup"           gboolean              : Read / Write / Construct

Текст метки включающий XML разметку. Смотрите pango_parse_markup().

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

Свойство "use-underline"

  "use-underline"        gboolean              : Read / Write / Construct

Если установлено, подчеркивание текста перед первым знаком указывает на мнемонический акселератор.

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

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

Свойство стиля "expander-size"

  "expander-size"        gint                  : Read

Размер стрелки расширителя.

Допустимые значения: >= 0

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

Свойство стиля "expander-spacing"

  "expander-spacing"     gint                  : Read

Интервал вокруг стрелки расширителя.

Допустимые значения: >= 0

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

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

Сигнал "activate"

void        user_function                  (GtkExpander *expander,
                                            gpointer     user_data)      : Run last / Action

Партнёры:

Хостинг: