GROUP (declare a group of controls)

Top  Previous  Next

 

 

GROUP(text)

,AT() [,CURSOR()][,USE()] [,LAYOUT( )] [,DISABLE][,KEY()][,MSG()][,HLP()][,FONT()][,TIP()]

 

 

[,BOXED][,FULL][,SCROLL][,HIDE][,ALRT()][,SKIP][,DROPID()][,COLOR()][,BEVEL()]

 

controls

 

 

END

 

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