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(). Каждая кнопка должна иметь текст и ID ответа.

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 в качестве виджета по умолчанию для диалога. Нажатие «Ввод» обычно активирует виджет по умолчанию.

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_dialog_get_response_for_widget ()

gint
gtk_dialog_get_response_for_widget (GtkDialog *dialog,
                                    GtkWidget *widget);

Получает ID ответа для виджета в области действий диалога.

С версии: 2.8

gtk_dialog_get_widget_for_response ()

GtkWidget *
gtk_dialog_get_widget_for_response (GtkDialog *dialog,
                                    gint response_id);

Получает кнопку виджета, использующую заданный ID ответа в области действий диалога.

С версии: 2.20

gtk_dialog_get_action_area ()

GtkWidget *
gtk_dialog_get_action_area (GtkDialog *dialog);

Возвращает область действий dialog.

С версии: 2.14

gtk_dialog_get_content_area ()

GtkWidget *
gtk_dialog_get_content_area (GtkDialog *dialog);

Возвращает область содержимого dialog.

С версии: 2.14

gtk_dialog_get_header_bar ()

GtkWidget *
gtk_dialog_get_header_bar (GtkDialog *dialog);

Возвращает панель заголовка диалогового окна dialog. Обратите внимание, что панель заголовка используется диалоговым окном только если свойство “use-header-bar” имеет значение TRUE.

С: 3.12

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