IdentifiantMot de passe
Mot de passe oublié ?Je m'inscris ! (gratuit)

Dialog QML Type

Popup dialog with standard buttons and a title, used for short-term interaction with the user.

Article lu   fois.

L'auteur

L'article

Publié le - Mis à jour le 14 février 2024 

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

Dialog QML Type▲

  • Import Statement: import QtQuick.Controls

  • Inherits: Popup

  • Group: Dialog is part of qtquickcontrols-dialogs, qtquickcontrols-popups

Detailed Description▲

A dialog is a popup mostly used for short-term tasks and brief communications with the user. Similarly to ApplicationWindow and Page, Dialog is organized into three sections: header, contentItem, and footer.

Image non disponible

By default, Dialogs have focus.

Dialog Title and Buttons▲

Dialog's title is displayed by a style-specific title bar that is assigned as a dialog header by default.

Dialog's standard buttons are managed by a DialogButtonBox that is assigned as a dialog footer by default. The dialog's standardButtons property is forwarded to the respective property of the button box. Furthermore, the accepted() and rejected() signals of the button box are connected to the respective signals in Dialog.

 
Sélectionnez
Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

Modal Dialogs▲

 
Sélectionnez
Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

Modeless Dialogs▲

A modeless dialog is a dialog that operates independently of other content around the dialog. When a modeless dialog is opened, the user is allowed to interact with both the dialog and the other content in the same window.

 
Sélectionnez
Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

See Also▲

See also DialogButtonBox, Popup Controls

Property Documentation▲

 

footer : Item▲

Assigning a DialogButtonBox as a dialog footer automatically connects its accepted() and rejected() signals to the respective signals in Dialog.

Assigning a DialogButtonBox, ToolBar, or TabBar as a dialog footer automatically sets the respective DialogButtonBox::position, ToolBar::position, or TabBar::position property to Footer.

See Also▲

See also header

header : Item▲

This property holds the dialog header item. The header item is positioned to the top, and resized to the width of the dialog. The default value is null.

Assigning a DialogButtonBox as a dialog header automatically connects its accepted() and rejected() signals to the respective signals in Dialog.

Assigning a DialogButtonBox, ToolBar, or TabBar as a dialog header automatically sets the respective DialogButtonBox::position, ToolBar::position, or TabBar::position property to Header.

See Also▲

See also footer

[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitFooterHeight : real▲

This property holds the implicit footer height.

The value is equal to footer && footer.visible ? footer.implicitHeight : 0.

This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).

See Also▲

See also implicitFooterWidth, implicitHeaderHeight

[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitFooterWidth : real▲

This property holds the implicit footer width.

The value is equal to footer && footer.visible ? footer.implicitWidth : 0.

This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).

See Also▲

See also implicitFooterHeight, implicitHeaderWidth

[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitHeaderHeight : real▲

This property holds the implicit header height.

The value is equal to header && header.visible ? header.implicitHeight : 0.

This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).

See Also▲

See also implicitHeaderWidth, implicitFooterHeight

[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitHeaderWidth : real▲

This property holds the implicit header width.

The value is equal to header && header.visible ? header.implicitWidth : 0.

This property was introduced in QtQuick.Controls 2.5 (Qt 5.12).

See Also▲

See also implicitHeaderHeight, implicitFooterWidth

[since QtQuick.Controls 2.3 (Qt 5.10)] result : int▲

This property holds the result code.

Standard result codes:

Constant

Description

Dialog.Accepted

The dialog was accepted.

Dialog.Rejected

The dialog was rejected.

This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also accept(), reject(), done()

standardButtons : enumeration▲

This property holds a combination of standard buttons that are used by the dialog.

 
Sélectionnez
Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

The buttons will be positioned in the appropriate order for the user's platform.

Possible flags:

Constant

Description

Dialog.Ok

An "OK" button defined with the AcceptRole.

Dialog.Open

An "Open" button defined with the AcceptRole.

Dialog.Save

A "Save" button defined with the AcceptRole.

Dialog.Cancel

A "Cancel" button defined with the RejectRole.

Dialog.Close

A "Close" button defined with the RejectRole.

Dialog.Discard

A "Discard" or "Don't Save" button, depending on the platform, defined with the DestructiveRole.

Dialog.Apply

An "Apply" button defined with the ApplyRole.

Dialog.Reset

A "Reset" button defined with the ResetRole.

Dialog.RestoreDefaults

A "Restore Defaults" button defined with the ResetRole.

Dialog.Help

A "Help" button defined with the HelpRole.

Dialog.SaveAll

A "Save All" button defined with the AcceptRole.

Dialog.Yes

A "Yes" button defined with the YesRole.

Dialog.YesToAll

A "Yes to All" button defined with the YesRole.

Dialog.No

A "No" button defined with the NoRole.

Dialog.NoToAll

A "No to All" button defined with the NoRole.

Dialog.Abort

An "Abort" button defined with the RejectRole.

Dialog.Retry

A "Retry" button defined with the AcceptRole.

Dialog.Ignore

An "Ignore" button defined with the AcceptRole.

Dialog.NoButton

An invalid button.
See Also▲

See also DialogButtonBox

title : string▲

This property holds the dialog title.

The title is displayed in the dialog header.

 
Sélectionnez
Dialog {
    title: qsTr("About")

    Label {
        text: "Lorem ipsum..."
    }
}

Signal Documentation▲

 

accepted()▲

This signal is emitted when the dialog has been accepted either interactively or by calling accept().

This signal is not emitted when closing the dialog with close() or setting visible to false.

The corresponding handler is onAccepted.

See Also▲

See also rejected()

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()▲

This signal is emitted when the Dialog.Apply standard button is clicked.

The corresponding handler is onApplied.

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also discarded(), reset()

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()▲

This signal is emitted when the Dialog.Discard standard button is clicked.

The corresponding handler is onDiscarded.

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also reset(), applied()

[since QtQuick.Controls 2.3 (Qt 5.10)] helpRequested()▲

This signal is emitted when the Dialog.Help standard button is clicked.

The corresponding handler is onHelpRequested.

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also accepted(), rejected()

rejected()▲

This signal is emitted when the dialog has been rejected either interactively or by calling reject().

This signal is not emitted when closing the dialog with close() or setting visible to false.

The corresponding handler is onRejected.

See Also▲

See also accepted()

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()▲

This signal is emitted when the Dialog.Reset standard button is clicked.

The corresponding handler is onReset.

This signal was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also discarded(), applied()

Method Documentation▲

 

void accept()▲

Emits the accepted() signal and closes the dialog.

See Also▲

See also reject(), done()

[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)▲

  1. Sets the result.

  2. Emits accepted() or rejected() depending on whether the result is Dialog.Accepted or Dialog.Rejected, respectively.

  3. Emits closed().

This method was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also accept(), reject(), result

void reject()▲

Emits the rejected() signal and closes the dialog.

See Also▲

See also accept(), done()

[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)▲

Returns the specified standard button, or null if it does not exist.

This method was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See Also▲

See also standardButtons

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+