Method

GtkNativeDialogrun

since: 3.20

Declaration [src]

gint
gtk_native_dialog_run (
  GtkNativeDialog* self
)

Description [src]

Blocks in a recursive main loop until self emits the GtkNativeDialog::response signal. It then returns the response ID from the ::response signal emission.

Before entering the recursive main loop, gtk_native_dialog_run() calls gtk_native_dialog_show() on the dialog for you.

After gtk_native_dialog_run() returns, then dialog will be hidden.

Typical usage of this function might be:

  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);

Note that even though the recursive main loop gives the effect of a modal dialog (it prevents the user from interacting with other windows in the same window group while the dialog is run), callbacks such as timeouts, IO channel watches, DND drops, etc, will be triggered during a gtk_native_dialog_run() call.

Available since: 3.20

Return value

Type: gint

Response ID.