AbstractButton QML Type

Abstrakter Basistyp, der die gemeinsamen Funktionen von Schaltflächen bereitstellt. Mehr…

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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)
• 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“ stellt die Schnittstelle für Steuerelemente mit schaltflächenähnlichem Verhalten bereit, beispielsweise Drucktasten und aktivierbare Steuerelemente wie Optionsfelder und Kontrollkästchen. Als abstraktes Steuerelement verfügt es über keine Delegat-Implementierungen; diese werden den davon abgeleiteten Typen überlassen.

Siehe auch „ ButtonGroup “ und „Button-Steuerelemente“.

Dokumentation zu den Eigenschaften

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 automatische Exklusivität aktiviert ist.

Ist die automatische Exklusivität aktiviert, verhalten sich aktivierbare Schaltflächen, die zum selben übergeordneten Element gehören, so, als wären sie Teil derselben „ ButtonGroup “. Es kann jeweils nur eine Schaltfläche aktiviert sein; wird eine andere Schaltfläche aktiviert, wird die zuvor aktivierte automatisch deaktiviert.

RadioButton und „ TabButton “ sind standardmäßig automatisch exklusiv.

autoRepeat : bool

Diese Eigenschaft legt fest, ob die Schaltfläche die Signale „ pressed()“, „ released()“ und „ clicked()“ wiederholt, solange 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 anfängliche Verzögerung und das Wiederholungsintervall werden in Millisekunden durch „ autoRepeatDelay “ und „ autoRepeatInterval “ definiert.

autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]

Diese Eigenschaft speichert die anfängliche Verzögerung der automatischen Wiederholung in Millisekunden. Der Standardwert beträgt „ 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 für die automatische Wiederholung in Millisekunden an. Der Standardwert beträgt 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 aktivierbar ist.

Eine aktivierbare Schaltfläche wechselt zwischen „aktiviert“ (ein) und „deaktiviert“ (aus), wenn der Benutzer darauf klickt oder die Leertaste drückt, während die Schaltfläche den Fokus hat.

Der Standardwert ist „ false “.

Siehe auch „ checked “.

checked : bool

Diese Eigenschaft gibt an, ob das Kontrollkästchen aktiviert ist.

Seit Qt 6.2 hat die Einstellung dieser Eigenschaft keinen Einfluss mehr auf die Eigenschaft „ checkable “. Setzen Sie bei Bedarf die Eigenschaft „ checkable “ explizit.

Siehe auch „ checkable “.

display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft legt fest, wie die Elemente „ icon “ und „ text “ innerhalb der Schaltfläche angezeigt werden.

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 optisch gedrückt ist.

Sofern nicht explizit festgelegt, übernimmt diese Eigenschaft den Wert von „ pressed “. Um zum Standardwert zurückzukehren, setzen Sie diese Eigenschaft auf „ undefined “.

Siehe auch „ pressed “.

icon group

Diese Eigenschaften wurden in QtQuick.Controls 2.3 eingeführt.

Siehe auch „ text“ , „ display “ und „Icons“ unter Qt Quick Controls.

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

Diese Eigenschaft enthält den impliziten Höhenindikator.

Der Wert entspricht „ indicator ? indicator.implicitHeight : 0 “.

Sie 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 [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Indikatorbreite.

Der Wert entspricht „ indicator ? indicator.implicitWidth : 0 “.

Sie wird typischerweise zusammen mit „ implicitContentWidth “ und „ implicitBackgroundWidth “ verwendet, um die „ 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 Kennzeichen.

pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]

Diese Eigenschaft enthält die x-Koordinate des letzten Tastendrucks.

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 des letzten Tastendrucks.

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 wurde. 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.

Siehe auch icon, display und contentItem.

Signal-Dokumentation

canceled()

Dieses Signal wird ausgelöst, wenn die Schaltfläche während des Drückens die Mauskontrolle verliert oder wenn sie das Signal „ released “ auslösen würde, sich der Mauszeiger jedoch nicht innerhalb der Schaltfläche befindet.

clicked()

Dieses Signal wird ausgelöst, wenn der Benutzer interaktiv per Touch, Maus oder Tastatur auf die Schaltfläche klickt.

Siehe auch „ click()“, „ animateClick()“ und „Aufruf einer C++-Funktion aus QML beim Klicken auf eine Schaltfläche“.

doubleClicked()

Dieses Signal wird ausgelöst, wenn der Benutzer interaktiv per Touch oder Maus einen Doppelklick auf die Schaltfläche ausführt.

pressAndHold()

Dieses Signal wird ausgelöst, wenn der Benutzer die Schaltfläche interaktiv per Touch oder Maus drückt und gedrückt hält. Es wird nicht ausgelöst, wenn „ autoRepeat “ aktiviert ist.

pressed()

Dieses Signal wird ausgelöst, wenn der Benutzer die Schaltfläche interaktiv per Touch, Maus oder Tastatur betätigt.

released()

Dieses Signal wird ausgelöst, wenn der Benutzer die Schaltfläche interaktiv per Berührung, Maus oder Tastatur loslässt.

[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()

Dieses Signal wird ausgelöst, wenn der Benutzer eine aktivierbare Schaltfläche interaktiv per Berührung, Maus oder Tastatur umschaltet.

Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Methodendokumentation

[since Qt 6.8] void animateClick()

Simuliert das Klicken auf die Schaltfläche mit einer Verzögerung von 100 Millisekunden zwischen dem Drücken und Loslassen und animiert dabei deren visuelle Darstellung.

Alle mit einem Klick verbundenen Signale werden entsprechend ausgesendet.

Wenn der „ focusPolicy “ den Wert „ Qt.ClickFocus “ enthält, ändert sich „ activeFocus “ in „ true “.

Diese Funktion führt keine Aktion aus, wenn die Schaltfläche den Status „ disabled “ hat.

Wird diese Funktion erneut aufgerufen, bevor die Schaltfläche losgelassen wird, wird der Release-Timer zurückgesetzt.

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 Schaltfläche, ohne dass zwischen dem Drücken und Loslassen eine Verzögerung auftritt.

Alle mit einem Klick verbundenen Signale werden entsprechend ausgegeben.

Wenn der „ focusPolicy “ den Wert „ Qt.ClickFocus “ enthält, wird „ activeFocus “ zu „ true “.

Diese Funktion führt keine Aktion aus, wenn die Schaltfläche den Status „ disabled “ hat.

Wird diese Funktion erneut aufgerufen, bevor die Schaltfläche losgelassen wird, wird der Release-Timer zurückgesetzt.

Diese Methode wurde in Qt 6.8 eingeführt.

Siehe auch „ animateClick()“, „ pressed()“, „ released()“ und „ clicked()“.

void toggle()

Schaltet den Markierungsstatus der Schaltfläche um.

Siehe auch click() und animateClick().