GtkDialog

gtk_dialog_new ()

GtkWidget *
gtk_dialog_new (void);

Создаёт новый диалоговый ящик.

В этот GtkWindow виджеты добавлять не следует, а в vbox и action_area, как описано выше.

gtk_dialog_new_with_buttons ()

GtkWidget *
gtk_dialog_new_with_buttons (const gchar *title,
                             GtkWindow *parent,
                             GtkDialogFlags flags,
                             const gchar *first_button_text,
                             ...);

Создаёт новый GtkDialog с заголовком title (или NULL для значения по умолчанию; см. gtk_window_set_title()) и временным родителем parent (или NULL для отсутствия; см. gtk_window_set_transient_for()). Аргумент flags можно использовать для создания модального диалогового окна (GTK_DIALOG_MODAL) и/или для его уничтожения вместе с временным родителем (GTK_DIALOG_DESTROY_WITH_PARENT). После flags должны следовать пары «текст кнопки/идентификатор ответа», завершаемые NULL указателем. Текст кнопки может быть произвольным. Идентификатор ответа может быть любым положительным числом или одним из значений в перечислении GtkResponseType. Если пользователь нажмёт одну из кнопок диалогового окна, GtkDialog выпустит сигнал “response” с соответствующим идентификатором ответа. Если GtkDialog получает сигнал “delete-event”, он выпустит ::response с идентификатором ответа GTK_RESPONSE_DELETE_EVENT. Однако, уничтожение диалогового окна не вызывает сигнал ::response; поэтому будьте осторожны, полагаясь на ::response при использовании флага GTK_DIALOG_DESTROY_WITH_PARENT. Кнопки расположены слева направо, поэтому первая кнопка в списке будет самой левой кнопкой в диалоговом окне.

Вот простой пример:

gtk_dialog_run ()

gint
gtk_dialog_run (GtkDialog *dialog);

Блокирует рекурсивный цикл главного потока до тех пор, пока dialog либо не выпустит сигнал “response”, либо не будет уничтожен. Если диалоговое окно уничтожается во время вызова gtk_dialog_run(), gtk_dialog_run() возвращает GTK_RESPONSE_NONE. В противном случае возвращает идентификатор ответа из выпущенного сигнала ::response.

Перед входом в рекурсивный цикл главного потока gtk_dialog_run() вызывает gtk_widget_show() для диалогового окна. Обратите внимание, что вам все равно необходимо отобразить любые дочерние элементы диалогового окна самостоятельно.

Во время gtk_dialog_run() поведение по умолчанию сигнала “delete-event” отключено; если диалоговое окно получает ::delete_event, оно не будет уничтожено, как это обычно происходит с окнами, и gtk_dialog_run() вернёт GTK_RESPONSE_DELETE_EVENT. Кроме того, во время gtk_dialog_run() диалоговое окно будет модальным. Вы можете принудительно вернуть gtk_dialog_run() в любой момент, вызвав gtk_dialog_response() для вызова сигнала ::response. Уничтожение диалогового окна во время gtk_dialog_run() — очень плохая идея, потому что ваш код после выполнения не узнает, было ли диалоговое окно уничтожено или нет.

После возвращения gtk_dialog_run() вы несете ответственность за скрытие или уничтожение диалогового окна, если это необходимо.

Типичное использование этой функции может быть:

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

gtk_dialog_response ()

void
gtk_dialog_response (GtkDialog *dialog,
                     gint response_id);

Вызывает сигнал “response” с указанным идентификатором ответа. Используется для указания того, что пользователь каким-то образом ответил на диалоговое окно; обычно вы или gtk_dialog_run() будете отслеживать сигнал ::response и предпринимать соответствующие действия.

gtk_dialog_add_button ()

GtkWidget *
gtk_dialog_add_button (GtkDialog *dialog,
                       const gchar *button_text,
                       gint response_id);

Добавляет кнопку с заданным текстом и настраивает вещи так, что нажатие кнопки вызовет сигнал “response” с заданным response_id. Кнопка добавляется в конец области действий диалогового окна. Виджет кнопки возвращается, но обычно вам он не нужен.

gtk_dialog_add_buttons ()

void
gtk_dialog_add_buttons (GtkDialog *dialog,
                        const gchar *first_button_text,
                        ...);

Добавляет дополнительные кнопки, то же самое, что вызов gtk_dialog_add_button() многократно. Список аргументов должен быть NULL-завершён, как в случае с gtk_dialog_new_with_buttons(). Каждая кнопка должна иметь текст и идентификатор ответа.

gtk_dialog_add_action_widget ()

void
gtk_dialog_add_action_widget (GtkDialog *dialog,
                              GtkWidget *child,
                              gint response_id);

Добавляет активируемый виджет в область действий GtkDialog, подключая обработчик сигнала, который будет генерировать сигнал “response” диалога при активации виджета. Виджет добавляется в конец области действий диалога. Если вы хотите добавить неактивируемый виджет, просто разместите его в поле action_area структуры GtkDialog.

gtk_dialog_set_default_response ()

void
gtk_dialog_set_default_response (GtkDialog *dialog,
                                 gint response_id);

Устанавливает последний виджет в области действий диалога с заданным response_id в качестве виджета по умолчанию для диалога. Нажатие «Enter» обычно активирует виджет по умолчанию.

gtk_dialog_set_response_sensitive ()

void
gtk_dialog_set_response_sensitive (GtkDialog *dialog,
                                   gint response_id,
                                   gboolean setting);

Вызывает gtk_widget_set_sensitive (widget, @setting) для каждого виджета в области действий диалога с заданным response_id . Удобный способ сделать кнопки диалога чувствительными/нечувствительными.

gtk_alternative_dialog_button_order ()

gboolean
gtk_alternative_dialog_button_order (GdkScreen *screen);

Возвращает TRUE если диалоговые окна ожидают использования альтернативного порядка кнопок на экране screen . Подробнее об альтернативном порядке кнопок см. gtk_dialog_set_alternative_button_order().

Если вам необходимо использовать эту функцию, вы, вероятно, должны подключиться к сигналу ::notify:gtk-alternative-button-order к объекту GtkSettings, связанному с screen, чтобы получать уведомления при изменении настроек порядка кнопок.

С версии: 2.6

gtk_dialog_set_alternative_button_order ()

void
gtk_dialog_set_alternative_button_order
                               (GtkDialog *dialog,
                                gint first_response_id,
                                ...);

Устанавливает альтернативный порядок кнопок. Если настройка “gtk-alternative-button-order” установлена в TRUE, кнопки диалогового окна переупорядочиваются в соответствии с порядком идентификаторов ответов, переданных в эту функцию.

По умолчанию, диалоговые окна GTK+ используют порядок кнопок, рекомендованный Руководством по человеко-машинному интерфейсу GNOME, с утвердительной кнопкой справа, а кнопкой отмены — слева от неё. Но встроенные диалоговые окна GTK+ и GtkMessageDialogs обеспечивают альтернативный порядок кнопок, который более подходит на некоторых платформах, например, Windows.

Используйте эту функцию после добавления всех кнопок в ваше диалоговое окно, как показано в следующем примере:

// Function to open a dialog box with a message
void
quick_message (GtkWindow *parent, gchar *message)
{
 GtkWidget *dialog, *label, *content_area;
 GtkDialogFlags flags;

 // Create the widgets
 flags = GTK_DIALOG_DESTROY_WITH_PARENT;
 dialog = gtk_dialog_new_with_buttons ("Message",
                                       parent,
                                       flags,
                                       _("_OK"),
                                       GTK_RESPONSE_NONE,
                                       NULL);
 content_area = gtk_dialog_get_content_area (GTK_DIALOG (dialog));
 label = gtk_label_new (message);

 // Ensure that the dialog box is destroyed when the user responds

 g_signal_connect_swapped (dialog,
                           "response",
                           G_CALLBACK (gtk_widget_destroy),
                           dialog);

 // Add the label, and show everything we’ve added

 gtk_container_add (GTK_CONTAINER (content_area), label);
 gtk_widget_show_all (dialog);
}

С версии: 2.6

gtk_dialog_set_alternative_button_order_from_array ()

void
gtk_dialog_set_alternative_button_order_from_array
                               (GtkDialog *dialog,
                                gint n_params,
                                gint *new_order);

Устанавливает альтернативный порядок кнопок. Если настройка “gtk-alternative-button-order” установлена в TRUE, кнопки диалогового окна переупорядочиваются в соответствии с порядком идентификаторов ответов в new_order .

См. gtk_dialog_set_alternative_button_order() для получения дополнительной информации.

Эта функция предназначена для использования языковыми интерфейсами.

С версии: 2.6