AbstractButton QML Type
Abstrakter Basistyp mit gemeinsamer Funktionalität für Schaltflächen. Mehr...
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: | Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton |
Eigenschaften
- action : Action
(since QtQuick.Controls 2.3 (Qt 5.10)) - autoExclusive : bool
- autoRepeat : bool
- autoRepeatDelay : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - autoRepeatInterval : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - checkable : bool
- checked : bool
- display : enumeration
(since QtQuick.Controls 2.3 (Qt 5.10)) - down : bool
- icon
- icon.cache : bool
- icon.color : color
- icon.height : int
- icon.name : string
- icon.source : url
- icon.width : int
- implicitIndicatorHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitIndicatorWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - indicator : Item
- pressX : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressY : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressed : bool
- text : string
Signale
- canceled()
- clicked()
- doubleClicked()
- pressAndHold()
- pressed()
- released()
- toggled()
(since QtQuick.Controls 2.2 (Qt 5.9))
Methoden
- void animateClick()
(since Qt 6.8) - void click()
(since Qt 6.8) - void toggle()
Ausführliche Beschreibung
AbstractButton bietet die Schnittstelle für Steuerelemente mit schaltflächenähnlichem Verhalten, z. B. Drucktasten und ankreuzbare Steuerelemente wie Optionsfelder und Kontrollkästchen. Als abstraktes Steuerelement verfügt es über keine Delegatenimplementierungen, sondern überlässt diese den Typen, die von ihm abgeleitet sind.
Siehe auch ButtonGroup und Button Controls.
Eigenschaft Dokumentation
action : Action |
Diese Eigenschaft enthält die Button-Aktion.
Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.
Siehe auch Action.
autoExclusive : bool |
Diese Eigenschaft gibt an, ob die Auto-Exklusivität aktiviert ist.
Wenn Auto-Exklusivität aktiviert ist, verhalten sich überprüfbare Schaltflächen, die zum selben übergeordneten Element gehören, so, als wären sie Teil desselben ButtonGroup. Es kann immer nur eine Schaltfläche geprüft werden; die Prüfung einer anderen Schaltfläche hebt automatisch die Prüfung der zuvor geprüften Schaltfläche auf.
Hinweis: Die Eigenschaft hat keine Auswirkungen auf Schaltflächen, die zu einem ButtonGroup gehören.
RadioButton und TabButton sind standardmäßig auto-exklusiv.
autoRepeat : bool |
Diese Eigenschaft legt fest, ob die Schaltfläche die Signale pressed(), released() und clicked() wiederholt, während die Schaltfläche gedrückt und gehalten wird.
Wenn diese Eigenschaft auf true gesetzt ist, wird das Signal pressAndHold() nicht ausgegeben.
Der Standardwert ist false.
Die Anfangsverzögerung und das Wiederholungsintervall werden durch autoRepeatDelay und autoRepeatInterval in Millisekunden definiert.
autoRepeatDelay : int |
Diese Eigenschaft enthält die anfängliche Verzögerung der automatischen Wiederholung in Millisekunden. Der Standardwert ist 300 ms.
Diese Eigenschaft wurde in QtQuick.Controls 2.4 (Qt 5.11) eingeführt.
Siehe auch autoRepeat und autoRepeatInterval.
autoRepeatInterval : int |
Diese Eigenschaft gibt das Intervall der automatischen Wiederholung in Millisekunden an. Der Standardwert ist 100 ms.
Diese Eigenschaft wurde in QtQuick.Controls 2.4 (Qt 5.11) eingeführt.
Siehe auch autoRepeat und autoRepeatDelay.
checkable : bool |
Diese Eigenschaft gibt an, ob die Schaltfläche überprüfbar ist.
Ein anklickbarer Button wechselt zwischen angeklickt (on) und nicht angeklickt (off), wenn der Benutzer darauf klickt oder die Leertaste drückt, während der Button den aktiven Fokus hat.
Der Standardwert ist false.
Siehe auch checked.
checked : bool |
display : enumeration |
Diese Eigenschaft bestimmt, wie icon und text innerhalb der Schaltfläche angezeigt werden.
| Anzeige | Ergebnis |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (Voreinstellung) |
|
AbstractButton.TextUnderIcon |
|
Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.
down : bool |
Diese Eigenschaftsgruppe wurde in QtQuick hinzugefügt. Controls 2.3.
| Name | Beschreibung |
|---|---|
| Name | Diese Eigenschaft enthält den Namen des zu verwendenden Symbols. Das Symbol wird aus dem Thema der Plattform geladen. Wenn das Symbol im Thema gefunden wird, wird es immer verwendet, auch wenn icon.source ebenfalls eingestellt ist. Wenn das Symbol nicht gefunden wird, wird stattdessen icon.source verwendet. Weitere Informationen über Theme-Symbole finden Sie unter QIcon::fromTheme(). |
| Quelle | Diese Eigenschaft enthält den Namen des zu verwendenden Symbols. Das Symbol wird als normales Bild geladen. Wenn icon.name gesetzt ist und auf ein gültiges Themensymbol verweist, wird es immer anstelle dieser Eigenschaft verwendet. |
| Breite | Diese Eigenschaft gibt die Breite des Symbols an. Die Breite des Symbols wird diesen Wert nie überschreiten, obwohl es bei Bedarf verkleinert wird. |
| Höhe | Diese Eigenschaft gibt die Höhe des Symbols an. Die Höhe des Symbols wird diesen Wert nie überschreiten, wird aber bei Bedarf verkleinert. |
| Farbe | Diese Eigenschaft enthält die Farbe des Symbols. Das Symbol wird mit der angegebenen Farbe eingefärbt, es sei denn, die Farbe ist auf |
| cache | Diese Eigenschaft gibt an, ob das Symbol zwischengespeichert werden soll. Der Standardwert ist true. Für weitere Informationen siehe cache. Diese Eigenschaft wurde eingeführt in QtQuick. Controls 2.13. |
Siehe auch text, display, und Icons in Qt Quick Controls.
implicitIndicatorHeight : real |
Diese Eigenschaft enthält die implizite Höhe des Indikators.
Der Wert ist gleich indicator ? indicator.implicitHeight : 0.
Diese Eigenschaft wird typischerweise zusammen mit implicitContentHeight und implicitBackgroundHeight verwendet, um die implicitHeight zu berechnen.
Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.
Siehe auch implicitIndicatorWidth.
implicitIndicatorWidth : real |
Diese Eigenschaft enthält die implizite Indikatorbreite.
Der Wert ist gleich indicator ? indicator.implicitWidth : 0.
Diese Eigenschaft wird normalerweise zusammen mit implicitContentWidth und implicitBackgroundWidth verwendet, um implicitWidth zu berechnen.
Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.
Siehe auch implicitIndicatorHeight.
indicator : Item |
Diese Eigenschaft enthält das Indikator-Element.
pressX : real |
Diese Eigenschaft enthält die x-Koordinate des letzten Drucks.
Hinweis: Der Wert wird bei Berührungsbewegungen aktualisiert, bleibt aber nach dem Loslassen der Berührung erhalten.
Diese Eigenschaft wurde in QtQuick.Controls 2.4 (Qt 5.11) eingeführt.
Siehe auch pressY.
pressY : real |
Diese Eigenschaft enthält die y-Koordinate der letzten Berührung.
Hinweis: Der Wert wird bei Berührungsbewegungen aktualisiert, bleibt aber nach dem Loslassen der Berührung erhalten.
Diese Eigenschaft wurde in QtQuick.Controls 2.4 (Qt 5.11) eingeführt.
Siehe auch pressX.
pressed : bool |
Diese Eigenschaft gibt an, ob die Schaltfläche physisch gedrückt ist. Eine Schaltfläche kann entweder durch Berührungs- oder Tastenereignisse gedrückt werden.
Siehe auch down.
text : string |
Diese Eigenschaft enthält eine textuelle Beschreibung der Schaltfläche.
Hinweis: Der Text wird für die Barrierefreiheit verwendet, daher ist es sinnvoll, eine textuelle Beschreibung festzulegen, auch wenn das Inhaltselement ein Bild ist.
Siehe auch icon, display, und contentItem.
Signal Dokumentation
canceled() |
Dieses Signal wird ausgegeben, wenn die Schaltfläche nicht mehr von der Maus erfasst wird, während sie gedrückt wird, oder wenn sie das Signal released ausgeben würde, der Mauszeiger sich aber nicht innerhalb der Schaltfläche befindet.
Hinweis: Der entsprechende Handler ist onCanceled.
clicked() |
Dieses Signal wird ausgegeben, wenn die Schaltfläche vom Benutzer interaktiv durch Berührung, Maus oder Tastatur angeklickt wird.
Hinweis: Der entsprechende Handler ist onClicked.
Siehe auch click(), animateClick(), und Call a C++ function from QML when a Button is clicked.
doubleClicked() |
Dieses Signal wird ausgegeben, wenn der Benutzer interaktiv mit der Maus oder per Touch auf die Schaltfläche klickt.
Hinweis: Der entsprechende Handler ist onDoubleClicked.
pressAndHold() |
Dieses Signal wird ausgegeben, wenn die Schaltfläche interaktiv durch den Benutzer per Touch oder Maus gedrückt und gehalten wird. Es wird nicht ausgegeben, wenn autoRepeat aktiviert ist.
Hinweis: Der entsprechende Handler ist onPressAndHold.
pressed() |
Dieses Signal wird ausgegeben, wenn die Schaltfläche vom Benutzer interaktiv durch Berührung, Maus oder Tastatur gedrückt wird.
Hinweis: Der entsprechende Handler ist onPressed.
released() |
Dieses Signal wird ausgegeben, wenn die Schaltfläche vom Benutzer durch Berührung, mit der Maus oder über die Tastatur losgelassen wird.
Hinweis: Der entsprechende Handler ist onReleased.
|
Dieses Signal wird ausgegeben, wenn eine ankreuzbare Schaltfläche vom Benutzer interaktiv durch Berührung, Maus oder Tastatur umgeschaltet wird.
Hinweis: Der entsprechende Handler ist onToggled.
Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.
Dokumentation der Methode
|
Simuliert das Anklicken der Schaltfläche mit einer Verzögerung von 100 Millisekunden zwischen Drücken und Loslassen und animiert dabei den visuellen Zustand der Schaltfläche.
Alle mit einem Klick verbundenen Signale werden entsprechend ausgegeben.
Wenn focusPolicy Qt.ClickFocus enthält, wird activeFocus zu true.
Diese Funktion ist wirkungslos, wenn die Schaltfläche disabled ist.
Ein erneuter Aufruf dieser Funktion, bevor die Schaltfläche losgelassen wird, setzt den Freigabe-Timer zurück.
Diese Methode wurde in Qt 6.8 eingeführt.
|
Simuliert das Anklicken der Taste ohne Verzögerung zwischen Drücken und Loslassen.
Alle mit einem Klick verbundenen Signale werden entsprechend ausgegeben.
Wenn focusPolicy Qt.ClickFocus enthält, wird activeFocus zu true.
Diese Funktion ist wirkungslos, wenn die Taste disabled ist.
Ein erneuter Aufruf dieser Funktion, bevor die Taste losgelassen wird, setzt den Freigabe-Timer zurück.
Diese Methode wurde in Qt 6.8 eingeführt.
Siehe auch animateClick(), pressed(), released(), und clicked().
void toggle() |
Schaltet den markierten Zustand der Schaltfläche um.
Siehe auch click() und animateClick().
© 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.
