GtkToggleButton

CSS узлы

GtkToggleButton имеет единственный CSS узел с именем button. Для различения его от обычной GtkButton применяется стилистический класс .toggle.

void make_toggles (void) {
   GtkWidget *dialog, *toggle1, *toggle2;
   GtkWidget *content_area;
   const char *text;

   dialog = gtk_dialog_new (text);
   content_area = gtk_dialog_get_content_area ();

   text = "Hi, i’m a toggle button.";
   toggle1 = gtk_toggle_button_new_with_label (text);

   // Makes this toggle button invisible
   gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle1),
                               TRUE);

   g_signal_connect (toggle1, "toggled",
                     G_CALLBACK (output_state),
                     NULL);
   gtk_box_pack_start (GTK_BOX (content_area),
                       toggle1, FALSE, FALSE, 2);

   text = "Hi, i’m a toggle button.";
   toggle2 = gtk_toggle_button_new_with_label (text);
   gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2),
                               FALSE);
   g_signal_connect (toggle2, "toggled",
                     G_CALLBACK (output_state),
                     NULL);
   gtk_box_pack_start (GTK_BOX (content_area),
                       toggle2, FALSE, FALSE, 2);

   gtk_widget_show_all (dialog);
}

gtk_toggle_button_new ()

GtkWidget *
gtk_toggle_button_new (void);

Создаёт новую кнопку переключения. Внутри виджета должна быть размещена какая-либо компонент, как в gtk_button_new().

gtk_toggle_button_new_with_label ()

GtkWidget *
gtk_toggle_button_new_with_label (const gchar *label);

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

gtk_toggle_button_new_with_mnemonic ()

GtkWidget *
gtk_toggle_button_new_with_mnemonic (const gchar *label);

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

gtk_toggle_button_set_mode ()

void
gtk_toggle_button_set_mode (GtkToggleButton *toggle_button,
                            gboolean draw_indicator);

Устанавливает, отображается ли кнопка как отдельный индикатор и метка. Вы можете вызвать эту функцию для переключателя или радиокнопки с draw_indicator = FALSE, чтобы кнопка выглядела как обычная кнопка.

Это можно использовать для создания связанной полосы кнопок, которая работает как GtkStackSwitcher.

Эта функция влияет только на экземпляры классов, таких как GtkCheckButton и GtkRadioButton, которые наследуются от GtkToggleButton, а не на экземпляры GtkToggleButton самого по себе.

gtk_toggle_button_get_mode ()

gboolean
gtk_toggle_button_get_mode (GtkToggleButton *toggle_button);

Возвращает, отображается ли кнопка как отдельный индикатор и метка. См. gtk_toggle_button_set_mode().

gtk_toggle_button_toggled ()

void
gtk_toggle_button_toggled (GtkToggleButton *toggle_button);

Вызывает сигнал “переключена” для GtkToggleButton. У приложения нет оснований для вызова этой функции.

gtk_toggle_button_get_active ()

gboolean
gtk_toggle_button_get_active (GtkToggleButton *toggle_button);

Получает состояние GtkToggleButton. Возвращает TRUE, если кнопка переключения нажата, и FALSE, если нет.

gtk_toggle_button_set_active ()

void
gtk_toggle_button_set_active (GtkToggleButton *toggle_button,
                              gboolean is_active);

Устанавливает состояние кнопки переключения. Установите значение TRUE, чтобы кнопка GtkToggleButton была нажата, и FALSE, чтобы снять нажатие. Это действие вызывает срабатывание сигнала “переключена” и сигнала “нажата”.

gtk_toggle_button_get_inconsistent ()

gboolean
gtk_toggle_button_get_inconsistent (GtkToggleButton *toggle_button);

Получает значение, установленное функцией gtk_toggle_button_set_inconsistent().

gtk_toggle_button_set_inconsistent ()

void
gtk_toggle_button_set_inconsistent (GtkToggleButton *toggle_button,
                                    gboolean setting);

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

struct GtkToggleButton

struct GtkToggleButton;

Свойство “active”

  “active”                   gboolean

Если переключатель должен быть нажат.

Флаги: Чтение / Запись

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

Свойство “draw-indicator”

  “draw-indicator”           gboolean

Если отображается переключательная часть кнопки.

Флаги: Чтение / Запись

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

Свойство “inconsistent”

  “inconsistent”             gboolean

Если переключатель находится в состоянии "между" состояниями.

Флаги: Чтение / Запись

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

Сигнал “toggled”

void
user_function (GtkToggleButton *togglebutton,
               gpointer         user_data)

Должен быть подключён, если требуется выполнить действие всякий раз, когда состояние GtkToggleButton изменяется.

Флаги: Выполнить сначала