| **Navigation:**  [[introduction.htm|Language Reference]] > 8 - Controls > Control Declarations >====== GROUP (declare a group of controls) ====== | [[entry  declare a data entry control .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[image  declare a graphic image control .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

|  | **GROUP(**//text//) | ,**AT()** [,**CURSOR()**][,**USE()**] [,**LAYOUT( )] **[,**DISABLE**][,**KEY()**][,**MSG()**][,**HLP()**][,**FONT()**][,**TIP()**] |
|  |  | [,**BOXED**][,**FULL**][,**SCROLL**][,**HIDE**][,**ALRT()**][,**SKIP**][,**DROPID()**][,**COLOR()**][,**BEVEL()**] |
|  | //controls// |  |
|  | **END** |  |

{{blk2blue.jpg|blk2blue.jpg}}

| **GROUP** | Declares a group of controls that may be referenced as one entity. |
| //text// | A string constant containing the prompt for the group of controls (PROP:Text). This may contain an ampersand (&) to indicate the "hot" letter for the prompt. The //text// is displayed on screen only if the BOXED attribute is also present. |
| **AT** | Specifies the initial size and location of the control (PROP:AT). If omitted, default values are selected by the runtime library. |
| **CURSOR** | Specifies a mouse cursor to display when the mouse is positioned over the control, or any control within the GROUP (PROP:CURSOR). If omitted, the window's CURSOR attribute is used, else the Windows default cursor is used. Not valid in a REPORT. |
| **USE** | A field equate label to reference the control in executable code (PROP:USE). |
| **LAYOUT** | Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT) |
| **DISABLE** | Specifies the GROUP control and the controls in the GROUP appear dimmed when the WINDOW or APPLICATION is first opened (PROP:DISABLE). Not valid in a REPORT. |
| **KEY** | Specifies an integer constant or keycode equate that immediately gives focus to the first control in the GROUP (PROP:KEY). Not valid in a REPORT. |
| **MSG** | Specifies a string constant containing the default text to display in the status bar when any control in the GROUP has focus (PROP:MSG). Not valid in a REPORT. |
| **HLP** | Specifies a string constant containing the default help system identifier for any control in the GROUP (PROP:HLP). Not valid in a REPORT. |
| **FONT** | Specifies the display font for the control and the default for all the controls in the GROUP (PROP:FONT). |
| **TIP** | Specifies the text that displays as "balloon help" when the mouse cursor pauses over the control (PROP:ToolTip). Not valid in a REPORT. |
| **BOXED** | Specifies a single-track border around the group of controls with the text at the top of the border (PROP:BOXED). |
| **FULL** | Specifies the control expands to occupy the entire size of the WINDOW or REPORT band for any missing AT attribute width or height parameter (PROP:FULL). |
| **SCROLL** | Specifies the GROUP control and the controls in the GROUP scroll with the window (PROP:SCROLL). |
| **HIDE** | Specifies the GROUP control and the controls in the GROUP do not appear when the WINDOW or APPLICATION is first opened (PROP:HIDE). UNHIDE must be used to display them. |
| **ALRT** | Specifies "hot" keys active for the controls in the GROUP (PROP:ALRT). |
| **SKIP** | Specifies the controls in the GROUP do not receive input focus and may only be accessed with the mouse or accelerator key (PROP:SKIP). Not valid in a REPORT. |
| **DROPID** | Specifies the control may serve as a drop target for drag-and-drop actions (PROP:DROPID). Not valid in a REPORT. |
| **COLOR** | Specifies default background and selected colors for the controls in the GROUP (PROP:COLOR). |
| **BEVEL** | Specifies custom 3-D effect borders (PROP:BEVEL). Not valid in a REPORT. |
| //controls// | Control declarations that may be referenced as the GROUP. |

The **GROUP** control declares a group of controls to reference as one entity. It is valid in Clarion Win32 Windows, and also for REPORT structures in both Clarion Win32 and Clarion#. GROUP allows the user to use the cursor keys instead of the TAB key to move between the //controls// in the GROUP, and provides default MSG and HLP attributes for all controls in the GROUP. This control cannot receive input focus.

**Events Generated:**

| EVENT:Drop | A successful drag-and-drop to the control. |

**Example:**

**MDIChild WINDOW('Child One'),AT(0,0,320,200),MDI,MAX,HVSCROLL**

**          GROUP('Group 1'),USE(?G1),KEY(F10Key)**

**           ENTRY(@S8),AT(0,0,20,20),USE(?E1)**

**           ENTRY(@S8),AT(20,0,20,20),USE(?E2)**

**          END**

**          GROUP('Group 2'),USE(?G2),MSG('Group 2'),CURSOR(CURSOR:Wait)**

**           ENTRY(@S8),AT(40,0,20,20),USE(?E3)**

**           ENTRY(@S8),AT(60,0,20,20),USE(?E4)**

**          END**

**          GROUP('Group 3'),USE(?G3),AT(80,0,20,20),BOXED**

**           ENTRY(@S8),AT(80,0,20,20),USE(?E5)**

**           ENTRY(@S8),AT(100,0,20,20),USE(?E6)**

**          END**

**         END**

**CustRpt  REPORT,AT(1000,1000,6500,9000),THOUS**

**CustDetail DETAIL,AT(0,0,6500,1000)**

**            GROUP('Group 1'),USE(!G1),AT(80,0,20,20),BOXED**

**             STRING(@S8),AT(80,0,20,20),USE(E5)**

**             STRING(@S8),AT(100,0,20,20),USE(E6)**

**            END**

**            GROUP('Group 2'),USE(?G2),FONT('Arial',12)**

**             STRING(@S8),AT(120,0,20,20),USE(E7)**

**             STRING(@S8),AT(140,0,20,20),USE(E8)**

**            END**

**           END**

**         END**

**See Also:**

[[panel  declare a panel control .htm|PANEL]]