Trait gtk4::prelude::NativeDialogExt[][src]

pub trait NativeDialogExt: 'static {
Show 16 methods fn destroy(&self);
fn is_modal(&self) -> bool;
fn title(&self) -> Option<GString>;
fn transient_for(&self) -> Option<Window>;
fn is_visible(&self) -> bool;
fn hide(&self);
fn set_modal(&self, modal: bool);
fn set_title(&self, title: &str);
fn set_transient_for(&self, parent: Option<&impl IsA<Window>>);
fn show(&self);
fn set_visible(&self, visible: bool);
fn connect_response<F: Fn(&Self, ResponseType) + 'static>(
        f: F
    ) -> SignalHandlerId;
fn connect_modal_notify<F: Fn(&Self) + 'static>(
        f: F
    ) -> SignalHandlerId;
fn connect_title_notify<F: Fn(&Self) + 'static>(
        f: F
    ) -> SignalHandlerId;
fn connect_transient_for_notify<F: Fn(&Self) + 'static>(
        f: F
    ) -> SignalHandlerId;
fn connect_visible_notify<F: Fn(&Self) + 'static>(
        f: F
    ) -> SignalHandlerId;
Expand description

Required methods

Destroys a dialog.

When a dialog is destroyed, it will break any references it holds to other objects.

If it is visible it will be hidden and any underlying window system resources will be destroyed.

Note that this does not release any reference to the object (as opposed to destroying a Window) because there is no reference from the windowing system to the NativeDialog.

Returns whether the dialog is modal.


true if the dialog is set to be modal

Gets the title of the NativeDialog.


the title of the dialog, or None if none has been set explicitly. The returned string is owned by the widget and must not be modified or freed.

Fetches the transient parent for this window.


the transient parent for this window, or None if no transient parent has been set.

Determines whether the dialog is visible.


true if the dialog is visible

Hides the dialog if it is visible, aborting any interaction.

Once this is called the signal::NativeDialog::response signal will not be emitted until after the next call to show().

If the dialog is not visible this does nothing.

Sets a dialog modal or non-modal.

Modal dialogs prevent interaction with other windows in the same application. To keep modal dialogs on top of main application windows, use set_transient_for() to make the dialog transient for the parent; most window managers will then disallow lowering the dialog below the parent.

whether the window is modal

Sets the title of the NativeDialog


title of the dialog

Dialog windows should be set transient for the main application window they were spawned from.

This allows window managers to e.g. keep the dialog on top of the main window, or center the dialog over the main window.

Passing None for @parent unsets the current transient window.


parent window

Shows the dialog on the display.

When the user accepts the state of the dialog the dialog will be automatically hidden and the signal::NativeDialog::response signal will be emitted.

Multiple calls while the dialog is visible will be ignored.

Whether the window is currently visible.

Emitted when the user responds to the dialog.

When this is called the dialog has been hidden.

If you call hide() before the user responds to the dialog this signal will not be emitted.


the response ID