Control QML Type

该属性用于保存从height 的控件中扣除垂直填充后contentItem 可用的高度。

另请参阅 Control Layout,padding,topPadding, 和bottomPadding 。

该属性表示从width 的控件中扣除水平填充后，contentItem 可用的宽度。

另请参阅 Control Layout,padding,leftPadding, 和rightPadding 。

该属性用于保存背景项。

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

另请参阅 Control Layout 。

该属性用于保存背景的底部嵌入。

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 Control Layout 和topInset 。

该属性用于设置底部填充。除非明确设置，否则该值等于verticalPadding 。

另请参阅 Control Layout,padding,topPadding,verticalPadding 和availableHeight 。

该属性用于保存可视化内容项。

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

另请参阅 Control Layout 和padding 。

该属性保存上次焦点变化的原因。

每次焦点转移时，Qt 都会修改该属性的值，因此您无需自行设置该属性。

另请参阅 Item::activeFocus 和visualFocus 。

该属性包含当前为控件设置的字体。

该属性描述控件要求的字体。在渲染标准组件时，控件的样式会使用该字体，该字体可确保自定义控件与本地平台的本地外观和感觉保持一致。不同的平台或不同的样式通常会为应用程序定义不同的字体。

默认字体取决于系统环境。ApplicationWindow 维护一个系统/主题字体，作为所有控件的默认字体。某些类型的控件还可能有特殊的默认字体。您也可以通过以下两种方式为控件设置默认字体：

• 在加载 QML 之前，向QGuiApplication::setFont() 传递自定义字体；或
• 在qtquickcontrols2.conf 文件中指定字体。

最后，字体会与 Qt 的字体数据库进行匹配，以找到最佳匹配。

控件会将显式字体属性从父控件传播到子控件。如果更改控件字体的特定属性，该属性会传播到控件的所有子控件，并覆盖该属性的任何系统默认值。

Page {
    font.family: "Courier"

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

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

有关可用字体属性的完整列表，请参阅font QML Value Type 文档。

该属性用于保存水平填充。除非明确设置，否则该值等于padding 。

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 Control Layout,padding,leftPadding,rightPadding 和verticalPadding 。

该属性决定控件是否接受悬停事件。默认值为Application.styleHints.useHoverEffects 。

设置该属性后，该值将传播给所有未显式设置hoverEnabled 的子控件。

您还可以通过设置QT_QUICK_CONTROLS_HOVER_ENABLED 环境变量，为所有Qt Quick Controls 应用程序启用或禁用悬停效果。

另请参阅 hovered 。

该属性可确定控件是否悬停。

另请参见 hoverEnabled 。

该属性表示隐式背景高度。

其值等于background ? background.implicitHeight : 0 。

该值通常与implicitContentHeight 一起用于计算implicitHeight ：

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

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 implicitBackgroundWidth 和implicitContentHeight 。

该属性保存隐式背景宽度。

其值等于background ? background.implicitWidth : 0 。

它通常与implicitContentWidth 一起用于计算implicitWidth ：

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

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 implicitBackgroundHeight 和implicitContentWidth 。

该属性保存隐式内容高度。

对于基本控件，其值等于contentItem ? contentItem.implicitHeight : 0 。对于继承 Container 或 Pane 的类型，该值根据内容子控件计算。

该属性通常与implicitBackgroundHeight 一起用于计算implicitHeight ：

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

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 implicitContentWidth 和implicitBackgroundHeight 。

该属性保存隐式内容宽度。

对于基本控件，其值等于contentItem ? contentItem.implicitWidth : 0 。对于继承 Container 或 Pane 的类型，该值根据内容子控件计算。

该属性通常与implicitBackgroundWidth 一起用于计算implicitWidth ：

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

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 implicitContentHeight 和implicitBackgroundWidth 。

该属性用于保存背景的左侧嵌入。

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 Control Layout 和rightInset 。

该属性用于设置左填充。除非明确设置，否则该值等于horizontalPadding 。

另请参阅 Control Layout,padding,rightPadding,horizontalPadding 和availableWidth 。

该属性用于保存控件的区域设置。

它包含用于格式化数据和数字的特定区域属性。除非设置了特殊的本地化设置，否则该本地化设置要么是父级本地化设置，要么是默认本地化设置。

控件会将父代的本地化传播给子代。如果更改了控件的本地化设置，该本地化设置就会传播到控件的所有子控件，并覆盖系统默认的本地化设置。

另请参阅 mirrored 。

该属性表示控件是否被镜像。

提供该属性是为了方便起见。当控件的视觉布局方向是从右到左时，即LayoutMirroring.enabled 是true 时，该控件被认为是镜像的。

从 Qt 6.2 起，locale 属性不再影响此属性。

另请参阅 LayoutMirroring 和从右向左的用户界面。

该属性保留默认的填充。

填充会在内容项和背景项的每个边缘之间添加一个空间，从而有效控制内容项的大小。要为控件的特定边缘指定填充值，请设置其相关属性：

• leftPadding
• rightPadding
• topPadding
• bottomPadding

padding: 0

而是设置每个特定属性：

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

另请参阅 Control Layout,availableWidth,availableHeight,topPadding,leftPadding,rightPadding, 和bottomPadding 。

该属性用于保存背景的右侧嵌入。

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 Control Layout 和leftInset 。

该属性用于设置右侧填充。除非明确设置，否则该值等于horizontalPadding 。

另请参见 Control Layout,padding,leftPadding,horizontalPadding 和availableWidth 。

该属性表示间距。

间距对于具有多个或重复构件的控件非常有用。例如，某些样式使用间距来确定CheckBox 的文本和指示符之间的距离。间距不是由 Control 强制执行的，因此每种样式可能会有不同的解释，有些样式可能会完全忽略它。

该属性用于保存背景的顶部嵌入。

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 Control Layout 和bottomInset 。

该属性用于保存顶部填充。除非明确设置，否则该值等于verticalPadding 。

另请参阅 Control Layout,padding,bottomPadding,verticalPadding 和availableHeight 。

该属性用于保存垂直填充。除非明确设置，否则该值等于padding 。

该属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 Control Layout,padding,topPadding,bottomPadding 和horizontalPadding 。

该属性表示控件是否具有视觉焦点。当控件具有活动焦点且焦点原因为Qt.TabFocusReason,Qt.BacktabFocusReason, 或Qt.ShortcutFocusReason 时，该属性为true 。

一般来说，对于可视化关键焦点，该属性比Item::activeFocus 更受青睐。这样可以确保只有在与按键交互时，而不是通过触摸或鼠标交互时，按键焦点才会可视化。

另请参见 focusReason 和Item::activeFocus 。

该属性决定控件是否处理滚轮事件。默认值为false 。