GtkCheckButton

gtk_check_button_new ()

GtkWidget *
gtk_check_button_new (void);

Создаёт новую кнопку GtkCheckButton.

gtk_check_button_new_with_label ()

GtkWidget *
gtk_check_button_new_with_label (const char *label);

Создаёт новую кнопку GtkCheckButton с меткой GtkLabel рядом, если label не NULL.

gtk_check_button_new_with_mnemonic ()

GtkWidget *
gtk_check_button_new_with_mnemonic (const char *label);

Создаёт новую кнопку GtkCheckButton с меткой. Подчёркивание в label указывает мнемонику для кнопки.

gtk_check_button_get_label ()

const char *
gtk_check_button_get_label (GtkCheckButton *self);

Возвращает метку кнопки.

gtk_check_button_set_label ()

void
gtk_check_button_set_label (GtkCheckButton *self,
                            const char *label);

Устанавливает текст self . Если “use-underline” TRUE, подчёркивание в label интерпретируется как мнемоника, см. gtk_check_button_set_use_underline() для подробностей.

gtk_check_button_get_use_underline ()

gboolean
gtk_check_button_get_use_underline (GtkCheckButton *self);

Возвращает текущее значение свойства “use-underline”.

gtk_check_button_set_use_underline ()

void
gtk_check_button_set_use_underline (GtkCheckButton *self,
                                    gboolean setting);

Устанавливает новое значение свойства “use-underline”. См. также gtk_check_button_get_use_underline().

Если setting TRUE, подчёркивание в метке self указывает мнемоническую клавишу-акселератор. Этот механизм аналогичен “use-underline”.

gtk_check_button_set_group ()

void
gtk_check_button_set_group (GtkCheckButton *self,
                            GtkCheckButton *group);

Добавляет self в группу group. В группе кнопок только одна кнопка может быть активной одновременно.

Установка группы кнопки также изменяет имя узла индикатора в CSS на 'radio'.

Поведение кнопки в группе также известно как 'кнопка радио'.

Обратите внимание, что того же эффекта можно достичь с помощью API GtkActionable, используя тот же action с типом параметра и типом состояния 's' для всех кнопок в группе и присваивая каждой кнопке своё целевое значение.

gtk_check_button_get_active ()

gboolean
gtk_check_button_get_active (GtkCheckButton *self);

Возвращает текущее значение свойства “active”.

gtk_check_button_set_active ()

void
gtk_check_button_set_active (GtkCheckButton *self,
                             gboolean setting);

Устанавливает новое значение свойства “active”. См. также gtk_check_button_get_active().

Установка “active” в TRUE добавит состояние :checked: к кнопке и узлу индикатора CSS.

gtk_check_button_get_inconsistent ()

gboolean
gtk_check_button_get_inconsistent (GtkCheckButton *check_button);

Возвращает, находится ли кнопка в несогласованном состоянии.

gtk_check_button_set_inconsistent ()

void
gtk_check_button_set_inconsistent (GtkCheckButton *check_button,
                                   gboolean inconsistent);

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