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

#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