控制 QML 类型

此属性表示从控制器的高度中减去垂直填充后的可用高度，用于contentItem。

另请参阅 控件布局、填充、顶部填充和底部填充。

此属性表示从控制器的宽度中减去水平填充后的可用宽度，用于contentItem。

另请参阅 控件布局、填充、左侧填充和右侧填充。

此属性表示背景项。

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

另请参阅 控件布局。

此属性表示背景的底部内缩。

此属性是在 QtQuick.Controls 2.5 (Qt 5.12) 中引入的。

另请参阅 控件布局和顶部内缩。

此属性表示底部填充。除非显式设置，否则值等于 verticalPadding。

另请参阅 控件布局、填充、顶部填充、垂直填充和可用高度。

此属性表示可视内容项。

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

另请参阅 控件布局和填充。

此属性表示最后焦点更改的原因。

另请参阅：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文档。

此属性保存了水平填充。

此属性是在 QtQuick.Controls 2.5 (Qt 5.12) 中引入的。

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

此属性确定控件是否接受悬停事件。默认值是 Qt.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) 中引入的。

另请参阅控制布局和 rightInset。

该属性保存左侧边距。除非明确设置，否则其值等于 horizontalPadding。

另请参阅控制布局、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

另请参阅 控制布局、可用宽度、可用高度、顶填充、左填充、右填充和 底填充。

该属性保存背景的右内边距。

此属性是在 QtQuick.Controls 2.5 (Qt 5.12) 中引入的。

另请参阅 控制布局 和 左内边距。

该属性保存右边距。除非显式设置，其值等于 horizontalPadding。

另请参阅 控制布局、padding、左填充、水平填充 和 可用宽度。

该属性保存间距。

间距对于具有多个或重复构建块的控制来说很有用。例如，某些样式使用间距来确定 CheckBox 中的文本和指示器之间的距离。控件不强制实施间距，因此每个样式可能会以不同的方式解释它，其中一些可能会完全忽略它。

该属性保存背景的顶部内边距。

此属性是在 QtQuick.Controls 2.5 (Qt 5.12) 中引入的。

另请参阅 控制布局 和 底部内边距。

该属性保存顶部填充。除非显式设置，其值等于 verticalPadding。

参阅控件布局、填充、底部填充、垂直填充和可用高度。

该属性保存垂直填充。除非显式设置，否则值等于填充。

此属性是在 QtQuick.Controls 2.5 (Qt 5.12) 中引入的。

参阅控件布局、填充、顶部填充、底部填充和水平填充。

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

通常，为了可视化键焦点，首选使用此属性而不是Item::activeFocus。这确保了只有在使用键盘交互时才会可视化键焦点 - 而不是通过触摸或鼠标交互。

参阅Item::focusReason和Item::activeFocus。

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