NativeDialog

Object Hierarchy:

Gtk.NativeDialog Gtk.NativeDialog Gtk.NativeDialog GLib.Object GLib.Object GLib.Object->Gtk.NativeDialog

Description:

[ CCode ( type_id = "gtk_native_dialog_get_type ()" ) ]
public abstract class NativeDialog : Object

Base class for platform dialogs that don't use `GtkDialog`.

Native dialogs are used in order to integrate better with a platform, by looking the same as other native applications and supporting platform specific features.

The [class@Gtk.Dialog] functions cannot be used on such objects, but we need a similar API in order to drive them. The `GtkNativeDialog` object is an API that allows you to do this. It allows you to set various common properties on the dialog, as well as show and hide it and get a [ signal@Gtk.NativeDialog:GtkNativeDialog:response] signal when the user finished with the dialog.

Note that unlike `GtkDialog`, `GtkNativeDialog` objects are not toplevel widgets, and GTK does not keep them alive. It is your responsibility to keep a reference until you are done with the object.

All known sub-classes:

Namespace: Gtk
Package: gtk4

Content:

Properties:

  • public bool modal { get; set; }
    Whether the window should be modal with respect to its transient parent.
  • public string? title { get; set; }
    The title of the dialog window
  • public Window? transient_for { get; set construct; }
    The transient parent of the dialog, or null for none.
  • public bool visible { get; set; }
    Whether the window is currently visible.

Creation methods:

Methods:

  • public void destroy ()
    Destroys a dialog.
  • public bool get_modal ()
    Returns whether the dialog is modal.
  • public unowned string? get_title ()
    Gets the title of the `GtkNativeDialog`.
  • public unowned Window? get_transient_for ()
    Fetches the transient parent for this window.
  • public bool get_visible ()
    Determines whether the dialog is visible.
  • public virtual void hide ()
    Hides the dialog if it is visible, aborting any interaction.
  • public void set_modal (bool modal)
    Sets a dialog modal or non-modal.
  • public void set_title (string? title)
    Sets the title of the `GtkNativeDialog.
  • public void set_transient_for (Window? parent)
    Dialog windows should be set transient for the main application window they were spawned from.
  • public virtual void show ()
    Shows the dialog on the display.

Signals:

  • public virtual signal void response (int response_id)
    Emitted when the user responds to the dialog.

Inherited Members:

All known members inherited from class GLib.Object