QML类型说明-GroupBox

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

这个组件的标题。没有默认标题文档。