Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkToggleAction

GtkToggleAction Действие выполнение которого выбирается из двух состояний

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

#include <gtk/gtk.h> GtkToggleAction; GtkToggleAction* gtk_toggle_action_new (const gchar *name, const gchar *label, const gchar *tooltip, const gchar *stock_id); void gtk_toggle_action_toggled (GtkToggleAction *action); void gtk_toggle_action_set_active (GtkToggleAction *action, gboolean is_active); gboolean gtk_toggle_action_get_active (GtkToggleAction *action); void gtk_toggle_action_set_draw_as_radio (GtkToggleAction *action, gboolean draw_as_radio); gboolean gtk_toggle_action_get_draw_as_radio (GtkToggleAction *action);

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

GObject +----GtkAction +----GtkToggleAction +----GtkRadioAction

Свойства

"active" gboolean : Read / Write "draw-as-radio" gboolean : Read / Write

Сигналы

"toggled" void user_function (GtkToggleAction *toggleaction, gpointer user_data) : Run first

Описание

GtkToggleAction примерно соответствует GtkCheckMenuItem. Он имеет состояние "active" определяющее должно ли действие иметь выбор или нет.

Детали

GtkToggleAction

typedef struct _GtkToggleAction GtkToggleAction;

GtkToggleAction структура содержит только закрытые данные к которым нет непосредственного доступа.


gtk_toggle_action_new ()

GtkToggleAction* gtk_toggle_action_new (const gchar *name, const gchar *label, const gchar *tooltip, const gchar *stock_id);

Создаёт новый объект GtkToggleAction. Для добавления действия к GtkActionGroup и установки акселератора для действия, вызовите gtk_action_group_add_action_with_accel().

name :

Уникальное имя действия

label :

Ярлык отображаемый в пунктах меню и кнопках

tooltip :

Подсказка для действия

stock_id :

Заготовленный значок для отображения в виджетах представляющих действие

Возвращает:

новый GtkToggleAction

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


gtk_toggle_action_toggled ()

void        gtk_toggle_action_toggled       (GtkToggleAction *action);

Издаёт сигнал "toggled" на выбранном действии.

action :

Объект действия

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


gtk_toggle_action_set_active ()

void gtk_toggle_action_set_active (GtkToggleAction *action, gboolean is_active);

Устанавливает флажок на выбранном действии.

action :

Объект действия

is_active :

Должно ли действие быть выбрано или нет

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


gtk_toggle_action_get_active ()

gboolean    gtk_toggle_action_get_active    (GtkToggleAction *action);

Возвращает состояние выборочного действия.

action :

Объект действия

Возвращает:

Состояние выборочного действия

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


gtk_toggle_action_set_draw_as_radio ()

void gtk_toggle_action_set_draw_as_radio (GtkToggleAction *action, gboolean draw_as_radio);

Устанавливает должно ли действие иметь полномочия как радио действия.

action :

Объект действия

draw_as_radio :

Должно ли действие иметь полномочия как радио действия

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


gtk_toggle_action_get_draw_as_radio ()

gboolean gtk_toggle_action_get_draw_as_radio (GtkToggleAction *action);

Определяет имеет ли действие полномочия как радио действие.

action :

Объект действия

Возвращает:

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

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

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

Свойство "active"

  "active"               gboolean              : Read / Write

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

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

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


Свойство "draw-as-radio"

  "draw-as-radio"        gboolean              : Read / Write

Должны ли полномочия для этого действия выглядеть как полномочия радио действия.

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

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

Сигнал "toggled"

void user_function (GtkToggleAction *toggleaction, gpointer user_data) : Run first

toggleaction :

Объект получающий сигнал.

user_data :

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