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

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

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

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

Свойства

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

Сигналы

Описание

GtkCheckMenuItem это пункт меню поддерживающий состояние булево значения в дополнение к обычной роли GtkMenuItem's в активируемом коде приложения.

Флажок (check box) указывающий булево значение состояния, отображается с левой стороны GtkMenuItem. Активизация GtkMenuItem переключает состояние.

Детали

GtkCheckMenuItem

typedef struct _GtkCheckMenuItem GtkCheckMenuItem;

 GtkCheckMenuItem структура
содержит нижеследующие поля. (Эти поля
должны рассматриваться только для
чтения. Они никогда не должны устанавливаться
приложением.) 


	
	
	

		

			
guint active;
		
		

			
TRUE если флажок ативен.
		
	


gtk_check_menu_item_new ()
GtkWidget*  gtk_check_menu_item_new         (void);

Создаёт новый GtkCheckMenuItem. 


	
	
	

		

			
Возвращает :
		
		

			
новый GtkCheckMenuItem. 
			
		
	


gtk_check_menu_item_new_with_label ()
GtkWidget*  gtk_check_menu_item_new_with_label
                                            (const gchar *label);

Создаёт новый GtkCheckMenuItem с ярлыком.


	
	
	

		

			
label :
		
		

			
Строка используемая как ярлык. 
			
		
	
	

		

			
Возвращает :
		
		

			
новый GtkCheckMenuItem. 
			
		
	


gtk_check_menu_item_new_with_mnemonic ()
GtkWidget*  gtk_check_menu_item_new_with_mnemonic
                                            (const gchar *label);

Создаёт новый GtkCheckMenuItem содержащий
ярлык. Ярлык должен быть создан с помощью
gtk_label_new_with_mnemonic(),
таким образом подчеркивание в label
указывает на мнемоник для пункта меню.

	
	
	

		

			
label :
		
		

			
Текст кнопки, с подчеркиванием
			спереди для мнемонического символа 
			
		
	
	

		

			
Возвращает :
		
		

			
новый GtkCheckMenuItem 
			
		
	


gtk_check_menu_item_set_state
#define gtk_check_menu_item_set_state           gtk_check_menu_item_set_active

Внимание
gtk_check_menu_item_set_state
устарела и не должна использоваться во
вновь создаваемом коде.
Этот макрос обеспечивает совместимость
с устаревшим кодом. Новый код должен
использовать gtk_check_menu_item_set_active()
вместо него. 


gtk_check_menu_item_get_active ()
gboolean    gtk_check_menu_item_get_active  (GtkCheckMenuItem *check_menu_item);

Определяет активен ли флажок пункта
меню. Смотрите gtk_check_menu_item_set_active().

	
	
	

		

			
check_menu_item :
		
		

			
GtkCheckMenuItem 
			
		
	
	

		

			
Возвращает :
		
		

			
TRUE
			если пункт меню активен. 
			
		
	


gtk_check_menu_item_set_active ()
void        gtk_check_menu_item_set_active  (GtkCheckMenuItem *check_menu_item,
                                             gboolean is_active);

Устанавливает активное состояние флажка
пункта меню. 


	
	
	

		

			
check_menu_item :
		
		

			
 GtkCheckMenuItem. 
			
		
	
	

		

			
is_active :
		
		

			
Булево значение указывающее активен
			ли флажок. 
			
		
	


gtk_check_menu_item_set_show_toggle ()
void        gtk_check_menu_item_set_show_toggle
                                            (GtkCheckMenuItem *menu_item,
                                             gboolean always);

Внимание
gtk_check_menu_item_set_show_toggle
устарела и не должна использоваться во
вновь создаваемом коде.
Контролирует должен ли флажок
отображаться всё время. Обычно флажок
отображается только когда он активен
или во время выделения пункта меню. 


	
	
	

		

			
menu_item :
		
		

			
 GtkCheckMenuItem. 
			
		
	
	

		

			
always :
		
		

			
Булево значение указывающее должен
			ли флажок отображаться всё время. 
			
		
	


gtk_check_menu_item_toggled ()
void        gtk_check_menu_item_toggled     (GtkCheckMenuItem *check_menu_item);

Издаёт сигнал GtkCheckMenuItem::toggled. 


	
	
	

		

			
check_menu_item :
		
		

			
 GtkCheckMenuItem. 
			
		
	


gtk_check_menu_item_get_inconsistent ()
gboolean    gtk_check_menu_item_get_inconsistent
                                            (GtkCheckMenuItem *check_menu_item);

Находит значение установленное с помощью
gtk_check_menu_item_set_inconsistent().

	
	
	

		

			
check_menu_item :
		
		

			
 GtkCheckMenuItem 
			
		
	
	

		

			
Возвращает :
		
		

			
TRUE
			если противоречивы 
			
		
	


gtk_check_menu_item_set_inconsistent ()
void        gtk_check_menu_item_set_inconsistent
                                            (GtkCheckMenuItem *check_menu_item,
                                             gboolean setting);

Если пользователь выбрал диапазон
элементов (таких как некоторый текст
или ячейки таблицы) которые задевают
булево настройки и текущие значения в
диапазоне противоречивы, вам может
понадобиться отобразить состояние
флажка в промежуточном состоянии "in
between". Эта функция включает промежуточное
состояние "in between". Обычно промежуточное
состояние выключается когда пользователь
выбирает настройку. Это выполняется
вручную, gtk_check_menu_item_set_inconsistent()
затрагивает только внешний вид, она не
влияет на семантику виджета.

	
	
	

		

			
check_menu_item :
		
		

			
 GtkCheckMenuItem 
			
		
	
	

		

			
setting :
		
		

			
TRUE
			для отображения промежуточного
			"inconsistent" состояния 
			
		
	


gtk_check_menu_item_set_draw_as_radio ()
void        gtk_check_menu_item_set_draw_as_radio
                                            (GtkCheckMenuItem *check_menu_item,
                                             gboolean draw_as_radio);

Устанавливает должен ли check_menu_item
выглядеть как GtkRadioMenuItem

	
	
	

		

			
check_menu_item :
		
		

			
 GtkCheckMenuItem 
			
		
	
	

		

			
draw_as_radio :
		
		

			
Должен ли check_menu_item
			выглядеть как GtkRadioMenuItem
						
		
	

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


gtk_check_menu_item_get_draw_as_radio ()
gboolean    gtk_check_menu_item_get_draw_as_radio
                                            (GtkCheckMenuItem *check_menu_item);

Определяет выглядит ли check_menu_item
как GtkRadioMenuItem

	
	
	

		

			
check_menu_item :
		
		

			
 GtkCheckMenuItem 
			
		
	
	

		

			
Возвращает :
		
		

			
Выглядит ли check_menu_item как
			GtkRadioMenuItem 
			
		
	

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

Детали свойств
Свойство "active"
  "active"               gboolean              : Read / Write

Активен ли пункт меню.
Значение по умолчанию: FALSE

Свойство "draw-as-radio"
  "draw-as-radio"        gboolean              : Read / Write

Выглядит ли пункт меню как радио-пункт
меню.
Значение по умолчанию: FALSE

Свойство "inconsistent"
  "inconsistent"         gboolean              : Read / Write

Отображается ли промежуточное состояние
"inconsistent".
Значение по умолчанию: FALSE
Детали свойств стиля
Свойство стиля "indicator-size"
  "indicator-size"       gint                  : Read

Размер флажка или радио-индикатора.
Допустимые значения: >= 0
Значение по умолчанию: 12
Детали сигнала
Сигнал "toggled"
void        user_function                  (GtkCheckMenuItem *checkmenuitem,
                                            gpointer          user_data)          : Run first

Этот сигнал издаётся когда состояние
флажка меняется. 

Обработчик сигнала проверяет active
поле в структуре GtkCheckMenuItem
для выявления нового состояния. 


	
	
	

		

			
checkmenuitem :
		
		

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

		

			
user_data :
		
		

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