Control QML Type

Diese Eigenschaft enthält die Höhe, die dem contentItem nach Abzug des vertikalen Paddings vom height des Steuerelements zur Verfügung steht.

Siehe auch Control Layout, padding, topPadding, und bottomPadding.

Diese Eigenschaft enthält die Breite, die dem contentItem nach Abzug der horizontalen Auffüllung des width des Steuerelements zur Verfügung steht.

Siehe auch Control Layout, padding, leftPadding, und rightPadding.

Diese Eigenschaft enthält das Hintergrundelement.

Button {
    id: control
    text: qsTr("Button")
    background: Rectangle {
        implicitWidth: 100
        implicitHeight: 40
        opacity: enabled ? 1 : 0.3
        color: control.down ? "#d0d0d0" : "#e0e0e0"
    }
}

Siehe auch Control Layout.

Diese Eigenschaft enthält den unteren Einschub für den Hintergrund.

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

Siehe auch Control Layout und topInset.

Diese Eigenschaft enthält die untere Auffüllung. Wenn nicht explizit gesetzt, ist der Wert gleich verticalPadding.

Siehe auch Control Layout, padding, topPadding, verticalPadding, und availableHeight.

Diese Eigenschaft enthält das visuelle Inhaltselement.

Button {
    id: control
    text: qsTr("Button")
    contentItem: Label {
        text: control.text
        verticalAlignment: Text.AlignVCenter
    }
}

Siehe auch Control Layout und padding.

Diese Eigenschaft enthält den Grund für den letzten Fokuswechsel.

Der Wert dieser Eigenschaft wird von Qt jedes Mal geändert, wenn der Fokus übertragen wird, und Sie sollten diese Eigenschaft nie selbst setzen müssen.

Siehe auch Item::activeFocus und visualFocus.

Diese Eigenschaft enthält die aktuell für das Steuerelement eingestellte Schriftart.

Diese Eigenschaft beschreibt die gewünschte Schriftart des Steuerelements. Die Schriftart wird vom Stil des Steuerelements beim Rendern von Standardkomponenten verwendet und steht als Mittel zur Verfügung, um sicherzustellen, dass benutzerdefinierte Steuerelemente die Konsistenz mit dem nativen Erscheinungsbild der jeweiligen Plattform beibehalten können. Es ist üblich, dass verschiedene Plattformen oder verschiedene Stile verschiedene Schriftarten für eine Anwendung definieren.

Die Standardschriftart hängt von der Systemumgebung ab. ApplicationWindow verwaltet eine System-/Theme-Schriftart, die als Standard für alle Steuerelemente dient. Für bestimmte Arten von Steuerelementen kann es auch spezielle Schriftvorgaben geben. Sie können die Standardschriftart für Steuerelemente auch festlegen, indem Sie entweder

• Übergabe einer benutzerdefinierten Schriftart an QGuiApplication::setFont(), bevor die QML geladen wird; oder
• die Schriftarten in der Datei qtquickcontrols2.conf angeben.

Schließlich wird die Schriftart mit der Qt-Schriftartdatenbank abgeglichen, um die beste Übereinstimmung zu finden.

Das Steuerelement überträgt explizite Schrifteigenschaften von den Eltern auf die Kinder. Wenn Sie eine bestimmte Eigenschaft der Schriftart eines Steuerelements ändern, wird diese Eigenschaft an alle untergeordneten Steuerelemente weitergegeben und setzt alle Systemvorgaben für diese Eigenschaft außer Kraft.

Page {
    font.family: "Courier"

    Column {
        Label {
            text: qsTr("This will use Courier...")
        }

        Switch {
            text: qsTr("... and so will this")
        }
    }
}

Eine vollständige Liste der verfügbaren Schrifteigenschaften finden Sie in der Dokumentation font QML Value Type.

Diese Eigenschaft enthält die horizontale Auffüllung. Wenn nicht explizit festgelegt, ist der Wert gleich padding.

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

Siehe auch Control Layout, padding, leftPadding, rightPadding, und verticalPadding.

Diese Eigenschaft legt fest, ob das Steuerelement Hover-Ereignisse annimmt. Der Standardwert ist Application.styleHints.useHoverEffects.

Wenn Sie diese Eigenschaft einstellen, wird der Wert auf alle untergeordneten Steuerelemente übertragen, für die nicht explizit hoverEnabled eingestellt ist.

Sie können auch Hover-Effekte für alle Qt Quick Controls Anwendungen aktivieren oder deaktivieren, indem Sie die Umgebungsvariable QT_QUICK_CONTROLS_HOVER_ENABLED setzen.

Siehe auch hovered.

Diese Eigenschaft gibt an, ob das Steuerelement mit dem Mauszeiger bewegt wird.

Siehe auch hoverEnabled.

Diese Eigenschaft enthält die implizite Hintergrundhöhe.

Der Wert ist gleich background ? background.implicitHeight : 0.

Diese Eigenschaft wird normalerweise zusammen mit implicitContentHeight verwendet, um die implicitHeight zu berechnen:

Control {
    implicitHeight: Math.max(implicitBackgroundHeight + topInset + bottomInset,
                             implicitContentHeight + topPadding + bottomPadding)
}

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

Siehe auch implicitBackgroundWidth und implicitContentHeight.

Diese Eigenschaft enthält die implizite Hintergrundbreite.

Der Wert ist gleich background ? background.implicitWidth : 0.

Diese Eigenschaft wird normalerweise zusammen mit implicitContentWidth verwendet, um die implicitWidth zu berechnen:

Control {
    implicitWidth: Math.max(implicitBackgroundWidth + leftInset + rightInset,
                            implicitContentWidth + leftPadding + rightPadding)
}

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

Siehe auch implicitBackgroundHeight und implicitContentWidth.

Diese Eigenschaft enthält die implizite Höhe des Inhalts.

Für einfache Steuerelemente ist der Wert gleich contentItem ? contentItem.implicitHeight : 0. Für Typen, die von Container oder Pane erben, wird der Wert auf der Grundlage der Inhaltskinder berechnet.

Dies wird normalerweise zusammen mit implicitBackgroundHeight verwendet, um implicitHeight zu berechnen:

Control {
    implicitHeight: Math.max(implicitBackgroundHeight + topInset + bottomInset,
                             implicitContentHeight + topPadding + bottomPadding)
}

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

Siehe auch implicitContentWidth und implicitBackgroundHeight.

Diese Eigenschaft enthält die implizite Breite des Inhalts.

Für einfache Steuerelemente ist der Wert gleich contentItem ? contentItem.implicitWidth : 0. Für Typen, die von Container oder Pane erben, wird der Wert auf der Grundlage der Inhaltskinder berechnet.

Dies wird normalerweise zusammen mit implicitBackgroundWidth verwendet, um implicitWidth zu berechnen:

Control {
    implicitWidth: Math.max(implicitBackgroundWidth + leftInset + rightInset,
                            implicitContentWidth + leftPadding + rightPadding)
}

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

Siehe auch implicitContentHeight und implicitBackgroundWidth.

Diese Eigenschaft enthält den linken Einschub für den Hintergrund.

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

Siehe auch Control Layout und rightInset.

Diese Eigenschaft enthält den linken Padding-Wert. Wenn nicht explizit gesetzt, ist der Wert gleich horizontalPadding.

Siehe auch Control Layout, padding, rightPadding, horizontalPadding, und availableWidth.

Diese Eigenschaft enthält das Gebietsschema des Steuerelements.

Sie enthält regionalspezifische Eigenschaften für die Formatierung von Daten und Zahlen. Sofern kein spezielles Gebietsschema festgelegt wurde, ist dies entweder das Gebietsschema des Elternteils oder das Standardgebietsschema.

Das Steuerelement überträgt das Gebietsschema vom übergeordneten Steuerelement auf die untergeordneten Steuerelemente. Wenn Sie das Gebietsschema des Steuerelements ändern, wird dieses Gebietsschema an alle untergeordneten Steuerelemente weitergegeben und setzt das Standardgebietsschema des Systems außer Kraft.

Siehe auch mirrored.

Diese Eigenschaft gibt an, ob das Steuerelement gespiegelt ist.

Diese Eigenschaft wird der Einfachheit halber bereitgestellt. Ein Steuerelement wird als gespiegelt betrachtet, wenn seine visuelle Layout-Richtung von rechts nach links ist; das heißt, wenn LayoutMirroring.enabled true ist.

Seit Qt 6.2 hat die Eigenschaft locale keinen Einfluss mehr auf diese Eigenschaft.

Siehe auch LayoutMirroring und Right-to-left User Interfaces.

Diese Eigenschaft enthält den Standard-Padding-Wert.

Padding fügt einen Abstand zwischen jeder Kante des Inhaltselements und dem Hintergrundelement hinzu, wodurch die Größe des Inhaltselements effektiv gesteuert wird. Um einen Auffüllungswert für eine bestimmte Kante des Steuerelements festzulegen, setzen Sie die entsprechende Eigenschaft:

• leftPadding
• rightPadding
• topPadding
• bottomPadding

padding: 0

Setzen Sie stattdessen jede spezifische Eigenschaft:

leftPadding: 0
rightPadding: 0
topPadding: 0
bottomPadding: 0

Siehe auch Control Layout, availableWidth, availableHeight, topPadding, leftPadding, rightPadding, und bottomPadding.

Diese Eigenschaft legt den rechten Einschub für den Hintergrund fest.

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

Siehe auch Control Layout und leftInset.

Diese Eigenschaft enthält den rechten Padding. Wenn nicht explizit gesetzt, ist der Wert gleich horizontalPadding.

Siehe auch Control Layout, padding, leftPadding, horizontalPadding, und availableWidth.

Diese Eigenschaft gibt den Abstand an.

Abstände sind nützlich für Steuerelemente, die mehrere oder sich wiederholende Bausteine haben. Einige Stile verwenden z. B. den Abstand, um den Abstand zwischen dem Text und dem Indikator von CheckBox zu bestimmen. Der Abstand wird von Control nicht erzwungen, so dass jeder Stil ihn anders interpretieren kann, und einige können ihn ganz ignorieren.

Diese Eigenschaft enthält den oberen Einschub für den Hintergrund.

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

Siehe auch Control Layout und bottomInset.

Diese Eigenschaft enthält die obere Auffüllung. Wenn nicht explizit gesetzt, ist der Wert gleich verticalPadding.

Siehe auch Control Layout, padding, bottomPadding, verticalPadding, und availableHeight.

Diese Eigenschaft enthält die vertikale Auffüllung. Wenn nicht explizit festgelegt, ist der Wert gleich padding.

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

Siehe auch Control Layout, padding, topPadding, bottomPadding, und horizontalPadding.

Diese Eigenschaft gibt an, ob das Steuerelement den visuellen Fokus hat. Diese Eigenschaft ist true, wenn das Steuerelement den aktiven Fokus hat und der Fokusgrund entweder Qt.TabFocusReason, Qt.BacktabFocusReason oder Qt.ShortcutFocusReason ist.

Im Allgemeinen wird diese Eigenschaft zur Visualisierung des Tastenfokus gegenüber Item::activeFocus bevorzugt. Dadurch wird sichergestellt, dass der Tastenfokus nur bei der Interaktion mit den Tasten visualisiert wird - nicht bei der Interaktion mit der Berührung oder der Maus.

Siehe auch focusReason und Item::activeFocus.

Diese Eigenschaft bestimmt, ob das Steuerelement Rad-Ereignisse verarbeitet. Der Standardwert ist false.