View source for Scout/Concepts/GroupBox

{{ScoutPage|cat=Component Model}}

Type of {{ScoutLink|Concepts|CompositeField|composite field}} to group other {{ScoutLink|Concepts|Field|fields}}.

* implements: {{ScoutJavadoc|IGroupBox|I}}
* extends: {{ScoutJavadoc|AbstractGroupBox|C}}

== Description ==
The GroupBox is a composite field to group Fields. 

The GroupBox can have a title and one of 4 different designs: 
* Default: The default design of a GroupBox
* Empty: No border and no title
* Line: Same as Default
* Section: The content can be hidden

== Screenshot ==
{|{{BMTableStyle}}
|-{{BMTHStyle}}
! RAP
! SWT
! Swing
! Swing Rayo
|-
| [[Image:Scout_3.8_GroupBox_RAP.png]] || [[Image:Scout_3.8_GroupBox_SWT.png]] || [[Image:Scout_3.8_GroupBox_Swing.png]] || [[Image:Scout_3.8_GroupBox_Swing_Rayo.png]]
|-
|}

== Properties ==
''Defined with {{ScoutLink|Concepts|GetConfigured Methods|getConfiguredXxxxxx()}} methods''.

See also the {{ScoutLink|Concepts|Field|Field}} and the {{ScoutLink|Concepts|CompositeField|Composite field}} pages for the properties that all fields have in common.

=== Layout ===
{{important|Required version|The BodyGrid property is included in Scout 4.0.0-M6 or bigger.}}

You can control the Layout with the property {{ScoutProp|BodyGrid}}. The default layout is '''vertical''' (first column top down and then next columns).

[[File:Scout Vertical GroupBox Grid.png]]

Corresponding code snippet:
<source lang="java">
  protected Class<? extends IGroupBoxBodyGrid> getConfiguredBodyGrid() {
    return VerticalSmartGroupBoxBodyGrid.class;
  }
</source>

An other Layout provided by Scout is '''horizontal''' (first row left to right and then next rows).

[[File:Scout Horizontal GroupBox Grid.png]]

Corresponding code snippet:
<source lang="java">
  protected Class<? extends IGroupBoxBodyGrid> getConfiguredBodyGrid() {
    return HorizontalGroupBoxBodyGrid.class;
  }
</source>

== Events ==
''Defined with {{ScoutLink|Concepts|Exec_Methods|execXxxxxx()}} methods''.

See also the {{ScoutLink|Concepts|Field|Field}} and the {{ScoutLink|Concepts|CompositeField|Composite field}} pages for the events that all fields have in common.


== See Also ==
* {{ScoutLink|Concepts|CompositeField|Composite field}}
* {{ScoutLink|Concepts|Field|Field}}
* {{ScoutLink|Concepts|Form|Form}}