AbstractButton QML Type
Abstrakter Basistyp mit gemeinsamer Funktionalität für Schaltflächen. Mehr...
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: |
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
(since QtQuick.Controls 2.3)- icon.cache : bool
(since QtQuick.Controls 2.3) - icon.color : color
(since QtQuick.Controls 2.3) - icon.height : int
(since QtQuick.Controls 2.3) - icon.name : string
(since QtQuick.Controls 2.3) - icon.source : url
(since QtQuick.Controls 2.3) - icon.width : int
(since QtQuick.Controls 2.3)
- icon.cache : bool
- 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.
Dokumentation der Eigenschaft
action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]
Diese Eigenschaft enthält die Aktion der Schaltfläche.
Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.
Siehe auch Action.
autoExclusive : bool
Diese Eigenschaft gibt an, ob die Autoexklusivität aktiviert ist.
Wenn die Autoexklusivität aktiviert ist, verhalten sich ankreuzbare 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 Taste die Signale pressed(), released() und clicked() wiederholt, während die Taste gedrückt und gehalten wird.
Wenn diese Eigenschaft auf true eingestellt ist, wird das Signal pressAndHold() nicht ausgegeben.
Der Standardwert ist false.
Die Anfangsverzögerung und das Wiederholungsintervall werden durch autoRepeatDelay und autoRepeatInterval in Millisekunden festgelegt.
autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]
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 [since QtQuick.Controls 2.4 (Qt 5.11)]
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 abhakbar ist.
Eine ankreuzbare Schaltfläche schaltet zwischen angekreuzt (ein) und nicht angekreuzt (aus) um, wenn der Benutzer darauf klickt oder die Leertaste drückt, während die Schaltfläche den aktiven Fokus hat.
Der Standardwert ist false.
Siehe auch checked.
checked : bool
Diese Eigenschaft gibt an, ob die Schaltfläche markiert ist.
Seit Qt 6.2 hat das Setzen dieser Eigenschaft keinen Einfluss mehr auf die Eigenschaft checkable. Setzen Sie bei Bedarf explizit die Eigenschaft checkable.
Siehe auch checkable.
display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]
Diese Eigenschaft bestimmt, wie icon und text innerhalb der Schaltfläche angezeigt werden.
| Anzeige | Ergebnis |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (Standard) |
|
AbstractButton.TextUnderIcon |
|
Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.
Siehe auch spacing und padding.
down : bool
Diese Eigenschaft gibt an, ob die Schaltfläche visuell gedrückt ist.
Sofern nicht explizit festgelegt, folgt diese Eigenschaft dem Wert von pressed. Um zum Standardwert zurückzukehren, setzen Sie diese Eigenschaft auf undefined.
Siehe auch pressed.
icon group
icon.cache : bool [since QtQuick.Controls 2.3]
icon.color : color [since QtQuick.Controls 2.3]
icon.height : int [since QtQuick.Controls 2.3]
icon.name : string [since QtQuick.Controls 2.3]
icon.source : url [since QtQuick.Controls 2.3]
icon.width : int [since QtQuick.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 in QtQuick.Controls 2.13 eingeführt. |
Diese Eigenschaften wurden in QtQuick.Controls 2.3 eingeführt.
Siehe auch text, display, und Icons in Qt Quick Controls.
implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Diese Eigenschaft enthält die implizite Indikatorhöhe.
Der Wert ist gleich indicator ? indicator.implicitHeight : 0.
Diese Eigenschaft wird normalerweise zusammen mit implicitContentHeight und implicitBackgroundHeight verwendet, um implicitHeight zu berechnen.
Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.
Siehe auch implicitIndicatorWidth.
implicitIndicatorWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Diese Eigenschaft enthält die implizite Indikatorbreite.
Der Wert ist gleich indicator ? indicator.implicitWidth : 0.
Diese Eigenschaft wird typischerweise 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 Anzeigeelement.
pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
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 [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
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 [read-only]
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 textliche 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 per Touch, Maus oder Tastatur interaktiv 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 die Schaltfläche durch den Benutzer interaktiv per Touch oder Maus doppelt angeklickt wird.
Hinweis: Der entsprechende Handler ist onDoubleClicked.
pressAndHold()
Dieses Signal wird ausgegeben, wenn der Benutzer die Schaltfläche interaktiv durch Berührung oder mit der Maus drückt und gedrückt hält. Es wird nicht ausgegeben, wenn autoRepeat aktiviert ist.
Hinweis: Der entsprechende Handler ist onPressAndHold.
pressed()
Dieses Signal wird ausgegeben, wenn die Schaltfläche durch den Benutzer interaktiv per Berührung, Maus oder Tastatur gedrückt wird.
Hinweis: Der entsprechende Handler ist onPressed.
released()
Dieses Signal wird ausgegeben, wenn der Benutzer die Schaltfläche interaktiv über Berührung, Maus oder Tastatur loslässt.
Hinweis: Der entsprechende Handler ist onReleased.
[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()
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
[since Qt 6.8] void animateClick()
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.
Siehe auch click(), pressed(), released(), und clicked().
[since Qt 6.8] void click()
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 Status der Schaltfläche "markiert" um.
Siehe auch click() und animateClick().
© 2026 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.
