GtkDialog

gtk_dialog_new ()

GtkWidget *
gtk_dialog_new (void);

Создаёт новое диалоговое окно.

Элементы управления не следует добавлять непосредственно в этот GtkWindow, а в content_area и action_area, как описано выше.

gtk_dialog_new_with_buttons ()

GtkWidget *
gtk_dialog_new_with_buttons (const char *title,
                             GtkWindow *parent,
                             GtkDialogFlags flags,
                             const char *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” с соответствующим идентификатором ответа. Если диалоговое окно получит событие закрытия, оно выпустит ::response с идентификатором ответа GTK_RESPONSE_DELETE_EVENT. Однако, уничтожение диалогового окна не вызывает сигнал ::response, поэтому будьте внимательны, опираясь на ::response при использовании флага GTK_DIALOG_DESTROY_WITH_PARENT.

Кнопки располагаются слева направо, поэтому первая кнопка в списке будет самой левой кнопкой в диалоговом окне.

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

// Function to open a dialog box with a message
void
quick_message (GtkWindow *parent, char *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_window_destroy),
                           dialog);

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

 gtk_box_append (GTK_BOX (content_area), label);
 gtk_widget_show (dialog);
}

gtk_dialog_response ()

void
gtk_dialog_response (GtkDialog *dialog,
                     int response_id);

Выпускает сигнал “response” с заданным идентификатором ответа.

Используется для указания того, что пользователь каким-либо образом ответил на диалоговое окно.

gtk_dialog-add-button ()

GtkWidget *
gtk_dialog_add_button (GtkDialog *dialog,
                       const char *button_text,
                       int response_id);

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

gtk_dialog_add_buttons ()

void
gtk_dialog_add_buttons (GtkDialog *dialog,
                        const char *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,
                              int response_id);

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

gtk_dialog_set_default_response ()

void
gtk_dialog_set_default_response (GtkDialog *dialog,
                                 int response_id);

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

gtk_dialog_set_response_sensitive ()

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

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

gtk_dialog_get_response_for_widget ()

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

Получает идентификатор ответа виджета в области действий диалога.

gtk_dialog_get_widget_for_response ()

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

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

gtk_dialog_get_content_area ()

GtkWidget *
gtk_dialog_get_content_area (GtkDialog *dialog);

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

gtk_dialog_get_header_bar ()

GtkWidget *
gtk_dialog_get_header_bar (GtkDialog *dialog);

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