GroupBox
ImportStatement: import QtQuick.Controls 1.2
Since: Qt 5.1
Inherits: FocusScope
Properties
checkable :bool
checked :bool
contentItem: Item
flat : bool
title :string
DetailedDescription
这个组件提供了一个框架,在顶部提供一个标题。在内部显示其他不同的组件。这个组件可以添加选择框。
GroupBox可设置成是否有选择框。子组件的打开关闭依赖于GroupBox是否被选择。
我们可以最小化contentItem消费的空间。通过设置flat属性为真,在大多数样式,会导致GroupBox只绘制边框。
在GroupBox中添加子组件,如果不是直接定义在GroupBox中,我们需要关联相应的contentItem属性。
GroupBox的隐式尺寸基于内容的尺寸计算。如果我们想锚定组件内部的子组件,需要显式的指明组件的宽于高。
下面的例子展示了如何应用Column 排列的GroupBox。
GroupBox {
title: qsTr("Package selection")
Column {
spacing: 2
CheckBox {
text: qsTr("Updatesystem")
}
CheckBox {
text: qsTr("Updateapplications")
}
CheckBox {
text: qsTr("Updatedocumentation")
}
}
}
PropertyDocumentation
checkable :bool
GroupBox在标题上是否有选择框决定组件是否被选择。如果属性为真,则GroupBox在标题部分使用带标签的选择框替代标题。如果选择框被选中,则子类打开,否则子类关闭并不可访问。默认没有复选框。
checked :bool
组件是否被选择。
如果GroupBox的checkable为真,它显示选择框。如果组件被选择,则子组件打开,否则,子组件关闭并不可访问。默认可选择的GroupBox也是选择的。
contentItem: Item
组件内部的子组件自动关联父为GroupBox的contentItem。如果子组件动态的创建,则需要显示的指定父为GroupBox的contentItem。
注意:GroupBox的隐式尺寸基于内容的尺寸计算。如果我们想锚定组件内部的子组件,需要显式的指明组件的宽于高。
flat : bool
组件是否画边框。GroupBox的边框包括顶部的标题和周围的边框。如果这个属性打开,在大多数风格,GroupBox只有顶部的标题被绘制,如果关闭,整个边框都被绘制。
默认属性是关闭的,所以组件会绘制整个边框。
注意在一些样式,flat和non-flat可能有相似的表现形式,不像其他样式那样区分开来。
title :string
这个组件的标题。没有默认标题文档。