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

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

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

С версии: 2.8

gtk_dialog_get_widget_for_response ()

GtkWidget *
gtk_dialog_get_widget_for_response (GtkDialog *dialog,
                                    gint response_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