GtkNativeDialog

gtk_native_dialog_show ()

void
gtk_native_dialog_show (GtkNativeDialog *self);

Отображает диалоговое окно на экране, позволяя пользователю взаимодействовать с ним. Когда пользователь принимает состояние диалогового окна, оно будет автоматически скрыто, и будет выпущен сигнал “response”.

Несколько вызовов, пока диалоговое окно отображено, будут проигнорированы.

С версии: 3.20

gtk_native_dialog_hide ()

void
gtk_native_dialog_hide (GtkNativeDialog *self);

Скрывает диалоговое окно, если оно отображено, прерывая любое взаимодействие. После этого вызова сигнал “response” не будет выпущен до следующего вызова gtk_native_dialog_show().

Если диалоговое окно не отображено, ничего не происходит.

С версии: 3.20

gtk_native_dialog_destroy ()

void
gtk_native_dialog_destroy (GtkNativeDialog *self);

Удаляет диалоговое окно.

При уничтожении диалогового окна, оно прерывает все ссылки на другие объекты. Если оно отображено, оно будет скрыто, а все соответствующие системные ресурсы будут уничтожены.

Обратите внимание, что это не освобождает ссылку на объект (в отличие от уничтожения GtkWindow), потому что система окон не ссылается на GtkNativeDialog.

С версии: 3.20

gtk_native_dialog_get_visible ()

gboolean
gtk_native_dialog_get_visible (GtkNativeDialog *self);

Определяет, отображено ли диалоговое окно.

С версии: 3.20

gtk_native_dialog_set_modal ()

void
gtk_native_dialog_set_modal (GtkNativeDialog *self,
                             gboolean modal);

Устанавливает диалоговое окно как модальное или немодальное. Модальные диалоговые окна предотвращают взаимодействие с другими окнами в том же приложении. Чтобы модальные диалоговые окна оставались поверх основных окон приложения, используйте gtk_native_dialog_set_transient_for(), чтобы сделать диалоговое окно дочерним для родительского; большинство менеджеров окон тогда не позволят расположить диалоговое окно ниже родительского.

С версии: 3.20

gtk_native_dialog_get_modal ()

gboolean
gtk_native_dialog_get_modal (GtkNativeDialog *self);

Возвращает, является ли диалоговое окно модальным. См. gtk_native_dialog_set_modal().

С версии: 3.20

gtk_native_dialog_set_title ()

void
gtk_native_dialog_set_title (GtkNativeDialog *self,
                             const char *title);

Устанавливает заголовок диалогового окна GtkNativeDialog.

С версии: 3.20

gtk_native_dialog_get_title ()

const char *
gtk_native_dialog_get_title (GtkNativeDialog *self);

Получает заголовок диалогового окна GtkNativeDialog.

С версии: 3.20

gtk_native_dialog_set_transient_for ()

void
gtk_native_dialog_set_transient_for (GtkNativeDialog *self,
                                     GtkWindow *parent);

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

Передача NULL для parent отменяет текущее дочернее окно.

С версии: 3.20

gtk_native_dialog_get_transient_for ()

GtkWindow *
gtk_native_dialog_get_transient_for (GtkNativeDialog *self);

Получает дочернее родительское окно для этого окна. См. gtk_native_dialog_set_transient_for().

С версии: 3.20

gtk_native_dialog_run ()

gint
gtk_native_dialog_run (GtkNativeDialog *self);

Блокирует выполнение в рекурсивном основном цикле до тех пор, пока self не выпустит сигнал “response”. Затем возвращает идентификатор ответа из сигнала ::response.

Перед входом в рекурсивный основной цикл, gtk_native_dialog_run() вызывает gtk_native_dialog_show() для диалогового окна.

После возвращения из gtk_native_dialog_run(), диалоговое окно будет скрыто.

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

gint result = gtk_native_dialog_run (GTK_NATIVE_DIALOG (dialog));
switch (result)
  {
    case GTK_RESPONSE_ACCEPT:
       do_application_specific_something ();
       break;
    default:
       do_nothing_since_dialog_was_cancelled ();
       break;
  }
g_object_unref (dialog);

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

С момента: 3.20