====== groupbox ======
{{ :groupbox_sample.png?300|Groupbox}}
Mit dem Wert **groupbox** für das [[Glossar#Attribut]] [[ctrltype]] kann man Datenfelder in [[GUI_Data_Sheets|DataSheets]] optisch gruppieren. Eine Groupbox hat sonst keine weitere Funktion.

===== Zugehörige Attribute =====
Um eine Groupbox in einem Formular zu definieren, müssen neben dem Attribut **ctrltype** noch weitere Attribute ausgefüllt sein. Prinzipiell können alle Attribute aus DataSheets verwendet werden, haben aber keine Bedeutung.

^Attribut ^Pflicht ^Funktion^
| forecolor| Ja | Definiert die [[Farbdefinition|Farbe]] der Groupbox mittels RGB Werten|
| labelcolor| Nein| Definiert die Farbe für den Text der Groupbox|
| height| Ja| Gesamthöhe der Groupbox einschließlich des linken senkrechten Balkens|
| width| :::| Breite der Groupbox|
| labelposleft| :::| Kann entfallen da der Labeltext immer auf der Groupbox liegt|

===== Tag-Name =====
Der Name des **Tag** hat keine Bedeutung, muss aber innerhalb des DataSheet Abschnitts eindeutig sein. Es empfiehlt sich folgende Namenskonvention: ''GROUPBOX_//<Sammelbegriff für die Datenfelder>//''.
===== Beispiel =====
<code xml><GROUPBOX_Sample ctrltype="groupbox" label="SAMPLE" left="7" top="69" width="359" height="89" labelcolor="255,255,255" forecolor="255,255,195" /></code>


{{tag>gui datasheet ctrltype}}