<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qquickgroupbox.cpp --> <title>GroupBox QML Type | Qt Labs Controls 5.6</title> <link rel="stylesheet" type="text/css" href="style/offline-simple.css" /> <script type="text/javascript"> window.onload = function(){document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");}; </script> </head> <body> <div class="header" id="qtdocheader"> <div class="main"> <div class="main-rounded"> <div class="navigationbar"> <table><tr> <td >Qt 5.6</td><td ><a href="qtlabscontrols-index.html">Qt Labs Controls</a></td><td ><a href="qt-labs-controls-qmlmodule.html">QML Types</a></td><td >GroupBox QML Type</td></tr></table><table class="buildversion"><tr> <td id="buildversion" width="100%" align="right">Qt 5.6.2 Reference Documentation</td> </tr></table> </div> </div> <div class="content"> <div class="line"> <div class="content mainContent"> <div class="sidebar"> <div class="toc"> <h3><a name="toc">Contents</a></h3> <ul> <li class="level1"><a href="#properties">Properties</a></li> <li class="level1"><a href="#details">Detailed Description</a></li> <li class="level2"><a href="#checkable-groupbox">Checkable GroupBox</a></li> </ul> </div> <div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">GroupBox QML Type</h1> <span class="subtitle"></span> <!-- $$$GroupBox-brief --> <p>A group box control. <a href="#details">More...</a></p> <!-- @@@GroupBox --> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import Qt.labs.controls 1.0</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <p><a href="qml-qt-labs-controls-frame.html">Frame</a></p> </td></tr></table></div><ul> <li><a href="qml-qt-labs-controls-groupbox-members.html">List of all members, including inherited members</a></li> </ul> <a name="properties"></a> <h2 id="properties">Properties</h2> <ul> <li class="fn"><b><b><a href="qml-qt-labs-controls-groupbox.html#label-prop">label</a></b></b> : Item</li> <li class="fn"><b><b><a href="qml-qt-labs-controls-groupbox.html#title-prop">title</a></b></b> : string</li> </ul> <!-- $$$GroupBox-description --> <a name="details"></a> <h2 id="details">Detailed Description</h2> </p> <p><a href="qml-qt-labs-controls-groupbox.html">GroupBox</a> is used to layout a logical group of controls together, within a titled visual frame. <a href="qml-qt-labs-controls-groupbox.html">GroupBox</a> does not provide a layout of its own, but requires you to position its contents, for instance by creating a RowLayout or a ColumnLayout.</p> <p>If only a single item is used within a <a href="qml-qt-labs-controls-groupbox.html">GroupBox</a>, it will resize to fit the implicit size of its contained item. This makes it particularly suitable for use together with layouts.</p> <p class="centerAlign"><img src="images/qtlabscontrols-groupbox.png" alt="" /></p><pre class="qml"> <span class="type"><a href="qml-qt-labs-controls-groupbox.html">GroupBox</a></span> { <span class="name">title</span>: <span class="name">qsTr</span>(<span class="string">"Synchronize"</span>) <span class="type">ColumnLayout</span> { <span class="name">anchors</span>.fill: <span class="name">parent</span> <span class="type"><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a></span> { <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"E-mail"</span>) } <span class="type"><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a></span> { <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"Calendar"</span>) } <span class="type"><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a></span> { <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"Contacts"</span>) } } } </pre> <a name="checkable-groupbox"></a> <h3 >Checkable GroupBox</h3> <p>Even though <a href="qml-qt-labs-controls-groupbox.html">GroupBox</a> has no built-in check box, it is straightforward to create a checkable <a href="qml-qt-labs-controls-groupbox.html">GroupBox</a> by pairing it with a <a href="qml-qt-labs-controls-checkbox.html">CheckBox</a>.</p> <p class="centerAlign"><img src="images/qtlabscontrols-groupbox-checkable.png" alt="" /></p><p>It is a common pattern to enable or disable the groupbox's children when its check box is toggled on/off, respectively, but the semantics of the check box is left to the application to decide.</p> <pre class="qml"> <span class="type"><a href="qml-qt-labs-controls-groupbox.html">GroupBox</a></span> { <span class="name">label</span>: <span class="name">CheckBox</span> { <span class="name">id</span>: <span class="name">checkBox</span> <span class="name">checked</span>: <span class="number">true</span> <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"Synchronize"</span>) } <span class="type">ColumnLayout</span> { <span class="name">anchors</span>.fill: <span class="name">parent</span> <span class="name">enabled</span>: <span class="name">checkBox</span>.<span class="name">checked</span> <span class="type"><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a></span> { <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"E-mail"</span>) } <span class="type"><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a></span> { <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"Calendar"</span>) } <span class="type"><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a></span> { <span class="name">text</span>: <span class="name">qsTr</span>(<span class="string">"Contacts"</span>) } } } </pre> <p><b>Note: </b><i>Types in the Qt.labs module are not guaranteed to remain compatible in future versions.</i></p><p><b>See also </b><a href="qml-qt-labs-controls-checkbox.html">CheckBox</a>, <a href="qtlabscontrols-customize.html#customizing-groupbox">Customizing GroupBox</a>, and <a href="qtlabscontrols-containers.html">Container Controls</a>.</p> <!-- @@@GroupBox --> <h2>Property Documentation</h2> <!-- $$$label --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="label-prop"> <td class="tblQmlPropNode"><p> <a name="label-prop"></a><span class="name">label</span> : <span class="type">Item</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the label item that visualizes <a href="qml-qt-labs-controls-groupbox.html#title-prop">title</a>.</p> <p><b>See also </b><a href="qtlabscontrols-customize.html#customizing-groupbox">Customizing GroupBox</a>.</p> </div></div><!-- @@@label --> <br/> <!-- $$$title --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="title-prop"> <td class="tblQmlPropNode"><p> <a name="title-prop"></a><span class="name">title</span> : <span class="type">string</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the title.</p> </div></div><!-- @@@title --> <br/> </div> </div> </div> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. </p> </div> </body> </html>