NativeDialog

Object Hierarchy:

Object hierarchy for NativeDialog

Description:

public abstract class NativeDialog : Object

Native dialogs are platform dialogs that don't use Dialog or Window.

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

The Dialog functions cannot be used on such objects, but we need a similar API in order to drive them. The NativeDialog 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 response signal when the user finished with the dialog.

There is also a run helper that makes it easy to run any native dialog in a modal way with a recursive mainloop, similar to run.

All known sub-classes:

Namespace: Gtk
Package: gtk+-3.0

Content:

Properties:

  • public bool modal { set; get; }
    Whether the window should be modal with respect to its transient parent.
  • public string? title { set; get; }
    The title of the dialog window
  • public Window? transient_for { construct set; get; }
    The transient parent of the dialog, or null for none.
  • public bool visible { set; get; }
    Whether the window is currenlty 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 NativeDialog.
  • public weak 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 visilbe, aborting any interaction.
  • public int run ()
    Blocks in a recursive main loop until this emits the response signal.
  • public void set_modal (bool modal)
    Sets a dialog modal or non-modal.
  • public void set_title (string? title)
    Sets the title of the NativeDialog.
  • 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, allowing the user to interact with it.

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