Каталог документации / Раздел "Программирование, языки" / Оглавление документа

GTK+ 2.0 Tutorial
<<< Previous	Виджеты кнопки (The Button Widget)	Next >>>

Кнопки выбора или «радио-кнопка» (Radio Buttons)

Кнопки выбора подобны контроль-кнопкам за исключением того, что они создаются группами и в отдельно взятый момент времени может быть выбрана только одна из них. Это удобно там где нужно выбирать из нескольких возможных взаимоисключающих вариантов.

Создание кнопок выбора выполняется одним из этих вызовов:

GtkWidget *gtk_radio_button_new( GSList *group );
GtkWidget *gtk_radio_button_new_from_widget( GtkRadioButton *group );
GtkWidget *gtk_radio_button_new_with_label( GSList *group,
                                            const gchar  *label );
GtkWidget* gtk_radio_button_new_with_label_from_widget( GtkRadioButton *group,
                                                        const gchar    *label );
GtkWidget *gtk_radio_button_new_with_mnemonic( GSList *group,
                                               const gchar  *label );
GtkWidget *gtk_radio_button_new_with_mnemonic_from_widget( GtkRadioButton *group,
                                                           const gchar  *label );

Вы заметили наверное, что функции содержат дополнительные аргументы. Это нужно для выполнения группой кнопок выбора их обязанности должным образом. Если первый вызов gtk_radio_button_new() или gtk_radio_button_new_with_label() должен содержать NULL в качестве первого аргумента, то используйте:

GSList *gtk_radio_button_get_group( GtkRadioButton *radio_button );

Важно помнить, что gtk_radio_button_get_group() вызывается каждый раз, когда нужно добавить кнопку выбора в группу, используя в качестве аргумента предыдущую кнопку выбора. Результат передаётся в следующий вызов gtk_radio_button_new() или gtk_radio_button_new_with_label(). Это позволяет связать цепь кнопок выбора. Пример ниже проесняет это.

Вы можете немного сократить синтаксис, удалив переменную для содержания списка кнопок выбора:

     button2 = gtk_radio_button_new_with_label(
                 gtk_radio_button_get_group (GTK_RADIO_BUTTON (button1)),
                 "button2");

Варианты с _from_widget() позволяют создавать сокращенные функции в будущем, опуская вызов gtk_radio_button_get_group(). Эта форма используется для создания третьей кнопки в следующем примере:

     button2 = gtk_radio_button_new_with_label_from_widget(
                 GTK_RADIO_BUTTON (button1), 
                 "button2");

Также хорошей идеей может быть установка по умолчанию определяющая выбранную кнопку:

void gtk_toggle_button_set_active( GtkToggleButton *toggle_button,
                                   gboolean        state );

Это описано в секции о переключателях и работает таким же образом. Как только кнопки выбора сгруппированы, только одна из них может быть выбрана. Если пользователь нажмет сначала на одну кнопку выбора, а затем на другую, то первая создаст сигнал "toggled" (сообщит о переходе в неактивное состояние), а вторая создаст "toggled" сигнал сообщая об активизации.

Пример создания группы из трёх кнопок выбора.

#include <glib.h>
#include <gtk/gtk.h>
gint close_application( GtkWidget *widget,
                        GdkEvent  *event,
                        gpointer   data )
{
  gtk_main_quit ();
  return FALSE;
}
int main( int   argc,
          char *argv[] )
{
    GtkWidget *window = NULL;
    GtkWidget *box1;
    GtkWidget *box2;
    GtkWidget *button;
    GtkWidget *separator;
    GSList *group;
    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    g_signal_connect (G_OBJECT (window), "delete_event",
                      G_CALLBACK (close_application),
                      NULL);
    gtk_window_set_title (GTK_WINDOW (window), "radio buttons");
    gtk_container_set_border_width (GTK_CONTAINER (window), 0);
    box1 = gtk_vbox_new (FALSE, 0);
    gtk_container_add (GTK_CONTAINER (window), box1);
    gtk_widget_show (box1);
    box2 = gtk_vbox_new (FALSE, 10);
    gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
    gtk_box_pack_start (GTK_BOX (box1), box2, TRUE, TRUE, 0);
    gtk_widget_show (box2);
    button = gtk_radio_button_new_with_label (NULL, "button1");
    gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
    gtk_widget_show (button);
    group = gtk_radio_button_get_group (GTK_RADIO_BUTTON (button));
    button = gtk_radio_button_new_with_label (group, "button2");
    gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE);
    gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
    gtk_widget_show (button);
    button = gtk_radio_button_new_with_label_from_widget (GTK_RADIO_BUTTON (button),
                                                          "button3");
    gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
    gtk_widget_show (button);
    separator = gtk_hseparator_new ();
    gtk_box_pack_start (GTK_BOX (box1), separator, FALSE, TRUE, 0);
    gtk_widget_show (separator);
    box2 = gtk_vbox_new (FALSE, 10);
    gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
    gtk_box_pack_start (GTK_BOX (box1), box2, FALSE, TRUE, 0);
    gtk_widget_show (box2);
    button = gtk_button_new_with_label ("close");
    g_signal_connect_swapped (G_OBJECT (button), "clicked",
                              G_CALLBACK (close_application),
                              G_OBJECT (window));
    gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
    GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
    gtk_widget_grab_default (button);
    gtk_widget_show (button);
    gtk_widget_show (window);
    gtk_main ();
    return 0;
}

<<< Previous	Home	Next >>>
Check Buttons	Up	Adjustments

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру