DialogButtonBox QML Type

Eine Schaltflächenleiste, die in Dialogfeldern verwendet wird. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• alignment : flags
• buttonLayout : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• defaultButton : AbstractButton (since 6.11)
• defaultStandardButton : enumeration (since 6.11)
• delegate : Component
• position : enumeration
• standardButtons : enumeration

Zugehörige Eigenschaften

• buttonBox : DialogButtonBox
• buttonRole : enumeration

Signale

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

Methoden

• AbstractButton standardButton(StandardButton button)

Ausführliche Beschreibung

Dialogfelder und Meldungsfelder zeigen Schaltflächen in der Regel in einer Reihenfolge an, die den Benutzeroberflächenrichtlinien der jeweiligen Plattform entspricht. Die Reihenfolge der Schaltflächen in Dialogfeldern ist auf verschiedenen Plattformen stets unterschiedlich. Mit „DialogButtonBox“ kann ein Entwickler Schaltflächen hinzufügen, wobei automatisch die für die Plattform des Benutzers geeignete Reihenfolge verwendet wird.

Die meisten Schaltflächen in einem Dialogfeld erfüllen bestimmte Funktionen. Dazu gehören:

• Das Bestätigen oder Ablehnen des Dialogs.
• Hilfe anfordern.
• Ausführen von Aktionen im Dialog selbst (z. B. Felder zurücksetzen oder Änderungen übernehmen).

Es kann auch alternative Möglichkeiten geben, den Dialog zu schließen, die jedoch zu unerwünschten Ergebnissen führen können.

Die meisten Dialoge verfügen über Schaltflächen, die fast schon als Standard angesehen werden können (z. B. die Schaltflächen „ OK “ und „ Cancel “). Manchmal ist es praktisch, diese Schaltflächen auf standardisierte Weise zu erstellen.

Es gibt mehrere Möglichkeiten, „DialogButtonBox“ zu verwenden. Eine Möglichkeit besteht darin, die Standardschaltflächen anzugeben (z. B. „ OK “, „ Cancel “ und „ Save “) und die Schaltflächenbox die Schaltflächen einrichten zu lassen.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

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

Alternativ können Schaltflächen und ihre Funktionen manuell festgelegt werden:

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

Sie können auch normale Schaltflächen und Standardschaltflächen beliebig kombinieren.

Wenn in der Schaltflächenbox auf eine Schaltfläche geklickt wird, wird das Signal „ clicked()“ für die tatsächlich gedrückte Schaltfläche ausgegeben. Darüber hinaus werden die folgenden Signale automatisch ausgegeben, wenn eine Schaltfläche mit den entsprechenden Rollen gedrückt wird:

Siehe auch Dialog.

Dokumentation zu den Eigenschaften

alignment : flags

Diese Eigenschaft legt die Ausrichtung der Schaltflächen fest.

Mögliche Werte:

Standardmäßig ist keine bestimmte Ausrichtung festgelegt; beim Auslesen der Ausrichtungseigenschaft wird ein Standard-Flag-Wert zurückgegeben, der dem Wert 0 entspricht. Die Eigenschaft kann auf diesen Wert zurückgesetzt werden, indem ihr „ undefined “ zugewiesen wird. In diesem Fall wird die Größe der Schaltflächen so angepasst, dass sie den verfügbaren Platz ausfüllen.

buttonLayout : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die Richtlinie für das Anordnungsschema der Schaltflächen, die beim Anordnen der in der Schaltflächenbox enthaltenen Schaltflächen verwendet werden soll. Der Standardwert ist plattformabhängig.

Mögliche Werte:

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

defaultButton : AbstractButton [since 6.11]

Diese Eigenschaft enthält die Standardschaltfläche.

Die Standardschaltfläche wird auf „ highlighted “ gesetzt und erhält den Fokus.

Es kann nur eine Schaltfläche in der Schaltflächenbox als Standard festgelegt werden. Diese Eigenschaft kann nicht zusammen mit der Eigenschaft „ defaultStandardButton “ verwendet werden.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Siehe auch „ standardButtons “ und „ defaultStandardButton “.

defaultStandardButton : enumeration [since 6.11]

Diese Eigenschaft enthält die Standardschaltfläche.

Die Standardschaltfläche wird „ highlighted “ sein und den Fokus erhalten.

Es kann nur eine Schaltfläche in der Schaltflächenbox als Standard festgelegt werden. Diese Eigenschaft kann nicht zusammen mit der Eigenschaft „ defaultButton “ verwendet werden.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

Siehe auch „ standardButtons “ und „ defaultButton “.

delegate : Component

Diese Eigenschaft enthält einen Delegaten zum Erstellen von Standardschaltflächen.

DialogButtonBox Übernimmt nicht die Eigentümerschaft des Delegaten.

Siehe auch standardButtons.

position : enumeration

Diese Eigenschaft legt die Position der Schaltflächenbox fest.

Mögliche Werte:

Der Standardwert lautet „ Footer “.

Siehe auch „ Dialog::header “ und „ Dialog::footer “.

standardButtons : enumeration

Diese Eigenschaft enthält eine Kombination aus Standardschaltflächen, die von der Schaltflächenleiste verwendet werden.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.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 „ standardButton()“.

Dokumentation zu angehängten Eigenschaften

DialogButtonBox.buttonBox : DialogButtonBox [read-only attached]

Diese zugehörige Eigenschaft enthält die Schaltflächenbox, die diese Schaltfläche verwaltet, oder „ null “, falls sich die Schaltfläche nicht in einer Schaltflächenbox befindet.

DialogButtonBox.buttonRole : enumeration [attached]

Diese zugeordnete Eigenschaft legt die Rolle der einzelnen Schaltflächen in einer Schaltflächenbox fest.

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

Mögliche Werte:

Signal-Dokumentation

accepted()

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche geklickt wird, die mit „ AcceptRole “ oder „ YesRole “ definiert wurde.

Siehe auch rejected(), clicked() und helpRequested().

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

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche geklickt wird, die mit dem ApplyRole definiert wurde.

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

Siehe auch „ discarded()“ und „ reset()“.

clicked(AbstractButton button)

Dieses Signal wird ausgelöst, wenn auf einen „ button “ innerhalb der Schaltflächenbox geklickt wird.

Siehe auch „ accepted()“, „ rejected()“ und „ helpRequested()“.

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

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche geklickt wird, die mit dem „ DiscardRole “ definiert wurde.

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

Siehe auch „ reset()“ und „ applied()“.

helpRequested()

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche geklickt wird, die mit dem „ HelpRole “ definiert wurde.

Siehe auch „ accepted()“, „ rejected()“ und „ clicked()“.

rejected()

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche geklickt wird, die mit „ RejectRole “ oder „ NoRole “ definiert wurde.

Siehe auch accepted(), helpRequested() und clicked().

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

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche geklickt wird, die mit dem „ ResetRole “ definiert wurde.

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

Siehe auch „ discarded()“ und „ applied()“.

Methodendokumentation

AbstractButton standardButton(StandardButton button)

Gibt den angegebenen Standard button zurück oder null, falls dieser nicht existiert.

Siehe auch standardButtons.