Dialog QML Type

Popup-Dialog mit Standardschaltflächen und einem Titel, der für kurzfristige Interaktionen mit dem Benutzer verwendet wird. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• footer : Item
• header : Item
• implicitFooterHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitFooterWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• result : int (since QtQuick.Controls 2.3 (Qt 5.10))
• standardButtons : enumeration
• title : string

Signale

• accepted()
• applied() (since QtQuick.Controls 2.3 (Qt 5.10))
• discarded() (since QtQuick.Controls 2.3 (Qt 5.10))
• helpRequested() (since QtQuick.Controls 2.3 (Qt 5.10))
• rejected()
• reset() (since QtQuick.Controls 2.3 (Qt 5.10))

Methoden

• void accept()
• void done(int result) (since QtQuick.Controls 2.3 (Qt 5.10))
• void reject()
• AbstractButton standardButton(StandardButton button) (since QtQuick.Controls 2.3 (Qt 5.10))

Ausführliche Beschreibung

Ein Dialog ist ein Popup-Fenster, das hauptsächlich für kurzfristige Aufgaben und kurze Kommunikation mit dem Benutzer verwendet wird. Ähnlich wie ApplicationWindow und Page ist auch Dialog in drei Abschnitte unterteilt: header, contentItem, und footer.

Die Eigenschaften padding wirken sich nur auf das contentItem aus. Verwenden Sie die Eigenschaft spacing, um den Abstand zwischen Kopfzeile, contentItem und Fußzeile zu beeinflussen.

Standardmäßig haben Dialoge die Eigenschaft focus.

Dialogtitel und Schaltflächen

Die title des Dialogs wird durch eine stil-spezifische Titelleiste angezeigt, die standardmäßig als Dialog header zugewiesen ist.

Die Standardschaltflächen des Dialogs werden von einer DialogButtonBox verwaltet, die standardmäßig als footer zugewiesen ist. Die Eigenschaft standardButtons des Dialogs wird an die entsprechende Eigenschaft des Schaltflächenfelds weitergeleitet. Außerdem werden die Signale accepted() und rejected() des Schaltflächenfeldes mit den entsprechenden Signalen im Dialog verbunden.

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

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

Modale Dialoge

Ein modal Dialog blockiert die Eingabe in andere Inhalte unterhalb des Dialogs. Wenn ein modaler Dialog geöffnet wird, muss der Benutzer die Interaktion mit dem Dialog beenden und ihn schließen, bevor er auf andere Inhalte im selben Fenster zugreifen kann.

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

Modellfreie Dialoge

Ein modellloser Dialog ist ein Dialog, der unabhängig von anderen Inhalten um den Dialog herum funktioniert. Wenn ein modellloser Dialog geöffnet wird, kann der Benutzer sowohl mit dem Dialog als auch mit dem anderen Inhalt im selben Fenster interagieren.

Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

Siehe auch DialogButtonBox und Popup-Steuerelemente.

Eigenschaft Dokumentation

footer : Item

Diese Eigenschaft enthält das Fußzeilenelement des Dialogs. Das Fußzeilenelement wird am unteren Rand positioniert und in der Größe an die Breite des Dialogs angepasst. Der Standardwert ist null.

Siehe auch header.

header : Item

Diese Eigenschaft enthält das Kopfzeilenelement des Dialogs. Das Kopfzeilenelement wird oben positioniert und in der Größe an die Breite des Dialogs angepasst. Der Standardwert ist null.

Siehe auch footer.

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

Diese Eigenschaft enthält die implizite Höhe der Fußzeile.

Der Wert ist gleich footer && footer.visible ? footer.implicitHeight : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitFooterWidth und implicitHeaderHeight.

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

Diese Eigenschaft enthält die implizite Breite der Fußzeile.

Der Wert ist gleich footer && footer.visible ? footer.implicitWidth : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitFooterHeight und implicitHeaderWidth.

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

Diese Eigenschaft enthält die implizite Kopfhöhe.

Der Wert ist gleich header && header.visible ? header.implicitHeight : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitHeaderWidth und implicitFooterHeight.

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

Diese Eigenschaft enthält die implizite Kopfbreite.

Der Wert ist gleich header && header.visible ? header.implicitWidth : 0.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitHeaderHeight und implicitFooterWidth.

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

Diese Eigenschaft enthält den Ergebniscode.

Standard-Ergebniscodes:

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch accept(), reject(), und done().

standardButtons : enumeration

Diese Eigenschaft enthält eine Kombination von Standardschaltflächen, die vom Dialog verwendet werden.

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

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

Die Schaltflächen werden in der für die Plattform des Benutzers geeigneten Reihenfolge angeordnet.

Mögliche Flags:

Siehe auch DialogButtonBox.

title : string

Diese Eigenschaft enthält den Titel des Dialogs.

Der Titel wird in der Kopfzeile des Dialogs angezeigt.

Dialog {
    title: qsTr("About")

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

Signal-Dokumentation

accepted()

Dieses Signal wird ausgegeben, wenn der Dialog entweder interaktiv oder durch den Aufruf von accept() akzeptiert wurde.

Siehe auch rejected().

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

Dieses Signal wird ausgegeben, wenn die Standardschaltfläche Dialog.Apply angeklickt wird.

Dieses Signal wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch discarded() und reset().

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

Dieses Signal wird ausgegeben, wenn die Standardschaltfläche Dialog.Discard angeklickt wird.

Dieses Signal wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch reset() und applied().

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

Dieses Signal wird ausgegeben, wenn die Standardschaltfläche Dialog.Help angeklickt wird.

Dieses Signal wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch accepted() und rejected().

rejected()

Dieses Signal wird ausgegeben, wenn der Dialog entweder interaktiv oder durch den Aufruf von reject() abgelehnt wurde.

Siehe auch accepted().

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

Dieses Signal wird ausgegeben, wenn die Standardschaltfläche Dialog.Reset angeklickt wird.

Dieses Signal wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch discarded() und applied().

Dokumentation der Methode

void accept()

Gibt das Signal accepted() aus und schließt den Dialog.

Siehe auch reject() und done().

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

1. Setzt die result.
2. Gibt accepted() oder rejected() aus, je nachdem, ob das Ergebnis Dialog.Accepted oder Dialog.Rejected ist.
3. Gibt closed() aus.

Diese Methode wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch accept(), reject(), und result.

void reject()

Gibt das Signal rejected() aus und schließt den Dialog.

Siehe auch accept() und done().

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

Liefert den angegebenen Standard button, oder null, wenn er nicht existiert.

Diese Methode wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch standardButtons.