<doc>

<legacy_id>2446</legacy_id>

<name>group</name>

<type>object</type>

<syntax>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

<synonym>grp</synonym>

<synonym>background</synonym>

<synonym>bkgnd</synonym>

<synonym>bg</synonym>

</synonyms>

<classification>

<category>Objects &amp; Messages</category>

</classification>

<references>

<keyword tag="templateGroup">templateGroup Keyword</keyword>

</references>

<history>

<introduced version="1.0">Added.</introduced>

</history>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<summary>A <keyword tag="control">control</keyword> that contains other <glossary tag="control">controls</glossary>.</summary>

<examples>

<example>set the showBorder of last group to true</example>

<example>create group "Options"</example>

</examples>

<description>

<p>Use the <b>group</b> <glossary tag="object type">object type</glossary> to hold sets of <glossary tag="control">controls</glossary>, <glossary tag="radio button">radio-button clusters</glossary>, <glossary tag="menu bar">menu bars</glossary>, and <glossary tag="control">controls</glossary> to be displayed on more than one <keyword tag="card">card</keyword>.</p><p/><p><b>Comments:</b></p><p>A group is a set of controls that has been made into a single control. You can select, move, resize, or copy the group, and all the controls in it come with the group. You can show a border around the group (using its <b>border</b> <glossary tag="property">property</glossary>), a label (using the <property tag="showName">showName</property> <glossary tag="property">property</glossary>), or <glossary tag="scrollbar">scrollbars</glossary>.</p><p/><p>Groups can contain any type of control (including other nested groups).</p><p/><p>When referring to a group using the synonyms background, bkgnd, or bg, the reference is to one among the groups in a stack, rather than to one among the groups on a card. For example, the object reference background 1 indicates the first group in the current stack, not the lowest-layered group on the current card.</p><p/><p>The group object has a number of properties and messages associated with it. To see a list of messages that can be sent to a group as a result of user actions or internal LiveCode events, open the "LiveCode Language Dictionary" page of the main Documentation window, ensure that the group column is visible and use sort and filter to bring the relevant entries to the top</p>

</description>

</doc>