DialogButtonBox QML Type
Ein Schaltflächenfeld, das in Dialogen verwendet wird. Mehr...
Import Statement: | import QtQuick.Controls |
Inherits: |
Eigenschaften
- alignment : flags
- buttonLayout : enumeration
(since QtQuick.Controls 2.5 (Qt 5.12))
- delegate : Component
- position : enumeration
- standardButtons : enumeration
Beigefügte 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
In Dialogen und Meldungsfeldern werden die Schaltflächen normalerweise in einer Reihenfolge angezeigt, die den Schnittstellenrichtlinien für die jeweilige Plattform entspricht. Es ist unvermeidlich, dass verschiedene Plattformen ihre Dialogschaltflächen in unterschiedlicher Reihenfolge haben. DialogButtonBox ermöglicht es einem Entwickler, Schaltflächen hinzuzufügen und verwendet automatisch die für die Plattform des Benutzers geeignete Reihenfolge.
Die meisten Schaltflächen für einen Dialog folgen bestimmten Rollen. Solche Rollen umfassen:
- Akzeptieren oder Ablehnen des Dialogs.
- Um Hilfe bitten.
- Ausführen von Aktionen im Dialog selbst (z. B. Zurücksetzen von Feldern oder Anwenden von Änderungen).
Es kann auch alternative Möglichkeiten geben, den Dialog zu beenden, was zu destruktiven Ergebnissen führen kann.
Die meisten Dialoge verfügen über Schaltflächen, die fast als Standardschaltflächen angesehen werden können (z. B. OK und Cancel ). Manchmal ist es praktisch, diese Schaltflächen auf eine Standardart zu erstellen.
Es gibt mehrere Möglichkeiten, DialogButtonBox zu verwenden. Eine Möglichkeit besteht darin, die Standardschaltflächen (z. B. OK, Cancel, Save) anzugeben und die Schaltflächen von der Schaltflächenbox einrichten zu lassen.
DialogButtonBox { standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel onAccepted: console.log("Ok clicked") onRejected: console.log("Cancel clicked") }
Alternativ können die Schaltflächen und ihre Funktionen auch von Hand 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 mischen und anpassen.
Wenn eine Schaltfläche in der Schaltflächenbox angeklickt wird, wird das Signal clicked() für die tatsächliche Schaltfläche ausgegeben, die gedrückt wird. Darüber hinaus werden die folgenden Signale automatisch ausgegeben, wenn eine Schaltfläche mit der/den jeweiligen Rolle(n) gedrückt wird:
Rolle | Signal |
---|---|
AcceptRole , YesRole | accepted() |
ApplyRole | applied() |
DiscardRole | discarded() |
HelpRole | helpRequested() |
RejectRole , NoRole | rejected() |
ResetRole | reset() |
Siehe auch Dialog.
Eigenschaft Dokumentation
alignment : flags |
Diese Eigenschaft enthält die Ausrichtung der Schaltflächen.
Mögliche Werte:
Konstante | Beschreibung |
---|---|
Qt.AlignLeft | Die Schaltflächen sind linksbündig ausgerichtet. |
Qt.AlignHCenter | Die Schaltflächen sind horizontal zentriert. |
Qt.AlignRight | Die Schaltflächen sind rechtsbündig ausgerichtet. |
Qt.AlignTop | Die Schaltflächen sind nach oben ausgerichtet. |
Qt.AlignVCenter | Die Schaltflächen sind vertikal zentriert. |
Qt.AlignBottom | Die Schaltflächen sind nach unten ausgerichtet. |
Standardmäßig ist keine bestimmte Ausrichtung festgelegt; das Auslesen der Eigenschaft alignment ergibt einen Standard-Flag-Wert, der mit 0 verglichen wird. 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.
Hinweis: Diese Eigenschaft geht von einem horizontalen Layout der Schaltflächen aus. Beachten Sie, dass DialogButtonBox beim Ausführen des iOS-Stils ein vertikales Layout verwendet, wenn diese Eigenschaft auf einen anderen Wert als undefined
eingestellt ist und mehr als zwei Schaltflächen vorhanden sind. In allen anderen Fällen werden die Schaltflächen horizontal angeordnet.
buttonLayout : enumeration |
Diese Eigenschaft enthält die Schaltflächen-Layout-Richtlinie, die bei der Anordnung der in der Schaltflächenbox enthaltenen Schaltflächen verwendet werden soll. Der Standardwert ist plattformspezifisch.
Verfügbare Werte:
Konstant | Beschreibung |
---|---|
DialogButtonBox.WinLayout | Verwenden Sie eine Richtlinie, die für Anwendungen unter Windows geeignet ist. |
DialogButtonBox.MacLayout | Verwenden Sie eine Richtlinie, die für Anwendungen unter macOS geeignet ist. |
DialogButtonBox.KdeLayout | Verwenden Sie eine Richtlinie, die für Anwendungen unter KDE geeignet ist. |
DialogButtonBox.GnomeLayout | Verwenden Sie eine Richtlinie, die für Anwendungen unter GNOME geeignet ist. |
DialogButtonBox.AndroidLayout | Verwenden Sie eine Richtlinie, die für Anwendungen unter Android geeignet ist. |
Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.
delegate : Component |
Diese Eigenschaft enthält einen Delegaten für die Erstellung von Standardschaltflächen.
Siehe auch standardButtons.
position : enumeration |
Diese Eigenschaft enthält die Position des Schaltflächenfeldes.
Hinweis: Wenn die Buttonbox als Kopf- oder Fußzeile von ApplicationWindow oder Page zugewiesen ist, wird die entsprechende Position automatisch gesetzt.
Mögliche Werte:
Konstant | Beschreibung |
---|---|
DialogButtonBox.Header | Das Schaltflächenfeld befindet sich oben, als Fenster- oder Seitenkopf. |
DialogButtonBox.Footer | Das Schaltflächenfeld befindet sich unten, als Fenster- oder Seitenfuß. |
Der Standardwert ist Footer
.
Siehe auch Dialog::header und Dialog::footer.
standardButtons : enumeration |
Diese Eigenschaft enthält eine Kombination von Standardschaltflächen, die von der Schaltflächenbox 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:
Konstante | Beschreibung |
---|---|
DialogButtonBox.Ok | Eine "OK"-Schaltfläche, die mit der AcceptRole definiert wurde. |
DialogButtonBox.Open | Eine "Öffnen"-Schaltfläche, die mit der AcceptRole definiert wurde. |
DialogButtonBox.Save | Eine "Speichern"-Schaltfläche, die mit der AcceptRole definiert wurde. |
DialogButtonBox.Cancel | Eine "Abbrechen"-Schaltfläche, die mit der RejectRole definiert wird. |
DialogButtonBox.Close | Eine "Schließen"-Schaltfläche, die mit der RejectRole definiert wird. |
DialogButtonBox.Discard | Eine Schaltfläche "Verwerfen" oder "Nicht speichern", je nach Plattform, die mit DestructiveRole definiert wird. |
DialogButtonBox.Apply | Eine "Anwenden"-Schaltfläche, die mit der ApplyRole definiert wird. |
DialogButtonBox.Reset | Eine "Zurücksetzen"-Schaltfläche, die mit ResetRole definiert wird. |
DialogButtonBox.RestoreDefaults | Eine Schaltfläche "Standardeinstellungen wiederherstellen", die mit ResetRole definiert wird. |
DialogButtonBox.Help | Eine "Hilfe"-Schaltfläche, die mit HelpRole definiert wurde. |
DialogButtonBox.SaveAll | Eine Schaltfläche "Alles speichern", definiert mit AcceptRole . |
DialogButtonBox.Yes | Eine "Ja"-Schaltfläche, die mit YesRole definiert wurde. |
DialogButtonBox.YesToAll | Eine "Ja zu allen"-Schaltfläche, die mit YesRole definiert wurde. |
DialogButtonBox.No | Eine "Nein"-Schaltfläche, die mit der NoRole definiert wird. |
DialogButtonBox.NoToAll | Eine "Nein zu allen"-Schaltfläche, die mit der NoRole definiert wird. |
DialogButtonBox.Abort | Eine "Abbrechen"-Schaltfläche, die mit der RejectRole definiert wird. |
DialogButtonBox.Retry | Eine "Wiederholen"-Schaltfläche, die mit der AcceptRole definiert wird. |
DialogButtonBox.Ignore | Eine "Ignorieren"-Schaltfläche, die mit der AcceptRole definiert wurde. |
DialogButtonBox.NoButton | Eine ungültige Schaltfläche. |
Siehe auch standardButton().
Angehängte Eigenschaft Dokumentation
DialogButtonBox.buttonBox : DialogButtonBox |
Diese angehängte Eigenschaft enthält die Schaltflächenbox, die diese Schaltfläche verwaltet, oder null
, wenn sich die Schaltfläche nicht in einer Schaltflächenbox befindet.
DialogButtonBox.buttonRole : enumeration |
Diese angehängte Eigenschaft enthält die Rolle jeder Schaltfläche in einer Schaltflächenbox.
DialogButtonBox { Button { text: qsTr("Save") DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole } Button { text: qsTr("Close") DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole } }
Verfügbare Werte:
Konstante | Beschreibung |
---|---|
DialogButtonBox.InvalidRole | Die Schaltfläche ist ungültig. |
DialogButtonBox.AcceptRole | Ein Klick auf die Schaltfläche führt dazu, dass der Dialog akzeptiert wird (z. B. OK). |
DialogButtonBox.RejectRole | Ein Klick auf die Schaltfläche führt zur Ablehnung des Dialogs (z. B. Cancel). |
DialogButtonBox.DestructiveRole | Das Anklicken der Schaltfläche führt zu einer destruktiven Änderung (z. B. zum Verwerfen von Änderungen) und schließt den Dialog. |
DialogButtonBox.ActionRole | Das Anklicken der Schaltfläche führt zu Änderungen an den Elementen innerhalb des Dialogs. |
DialogButtonBox.HelpRole | Die Schaltfläche kann angeklickt werden, um Hilfe anzufordern. |
DialogButtonBox.YesRole | Die Schaltfläche ist eine "Ja"-ähnliche Schaltfläche. |
DialogButtonBox.NoRole | Die Schaltfläche ist eine "Nein"-ähnliche Schaltfläche. |
DialogButtonBox.ResetRole | Die Schaltfläche setzt die Felder des Dialogs auf die Standardwerte zurück. |
DialogButtonBox.ApplyRole | Die Schaltfläche wendet aktuelle Änderungen an. |
Signal Dokumentation
accepted() |
Dieses Signal wird ausgegeben, wenn eine mit AcceptRole
oder YesRole
definierte Schaltfläche angeklickt wird.
Hinweis: Der entsprechende Handler ist onAccepted
.
Siehe auch rejected(), clicked(), und helpRequested().
|
clicked(AbstractButton button) |
Dieses Signal wird ausgegeben, wenn ein button innerhalb der Buttonbox angeklickt wird.
Hinweis: Der entsprechende Handler ist onClicked
.
Siehe auch accepted(), rejected(), und helpRequested().
|
helpRequested() |
rejected() |
Dieses Signal wird ausgegeben, wenn eine Schaltfläche mit der Bezeichnung RejectRole
oder NoRole
angeklickt wird.
Hinweis: Der entsprechende Handler ist onRejected
.
Siehe auch accepted(), helpRequested(), und clicked().
|
Methode Dokumentation
AbstractButton standardButton(StandardButton button) |
Liefert den angegebenen Standard button, oder null
, wenn er nicht existiert.
Siehe auch standardButtons.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.