User Tools

Site Tools


tab_declare_a_page_of_a_sheet_control_.htm
Navigation:  Language Reference > 8 - Controls > Control Declarations >====== TAB (declare a page of a SHEET control) ====== Previous pageReturn to chapter overviewNext page

NewC7.jpg

TAB( text )[,USE()] [,DISABLE] [,LAYOUT( )] [,KEY()] [,MSG()] [,HLP()] [,REQ] [DROPID()] [,TIP()]

[,COLOR()] [,FONT()][,HIDE]
controls
END

blk2blue.jpg

TAB Declares a group of controls that constitute one of the multiple “pages” of controls contained within a SHEET structure.
text A string constant containing the text to display on the TAB (PROP:Text).
USE Specifies a field equate label to reference the control in executable code (PROP:USE).
DISABLE Specifies the control appears dimmed when the WINDOW or APPLICATION is first opened (PROP:DISABLE).
LAYOUT Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT)
KEY Specifies an integer constant or keycode equate that immediately gives focus to the control (PROP:KEY).
MSG Specifies a string constant containing the default text to display in the status bar when any control in the TAB has focus (PROP:MSG).
HLP Specifies a string constant containing the default help system identifier for any control in the TAB (PROP:HLP).
REQ Specifies that when another TAB is selected, the runtime library automatically checks all ENTRY controls in the same TAB structure with the REQ attribute to ensure they contain data other than blanks or zeroes (PROP:REQ).
DROPID Specifies the control may serve as a drop target for drag-and-drop actions (PROP:DROPID).
TIP Specifies the text that displays as “balloon help” when the mouse cursor pauses over the control (PROP:ToolTip).
COLOR Specifies a background color for the control and the default for all controls on the TAB (PROP:COLOR).
FONT Specifies the font used to display the text on the tab (PROP:FONT). This does not affect the controls placed in the TAB.
HIDE Specifies the control does not appear when the WINDOW or APPLICATION is first opened (PROP:HIDE). UNHIDE must be used to display it.
controls Multiple control declarations.

The TAB structure declares a group of controls that constitute one of the multiple “pages” of controls contained within a SHEET structure (not valid in a REPORT). The multiple TAB controls in the SHEET structure define the “pages” displayed to the user. The SHEET structure's USE attribute receives the text of the TAB control selected by the user.

Input focus changes between the SHEET's TAB controls are signalled only to the SHEET control affected. This means the events generated when the user changes input focus within a SHEET structure are field-specific events for the SHEET control, and the individual TAB controls do not generate events.

Example:

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

     SHEET,AT(0,0,320,175),USE(SelectedTab)

      TAB('Tab One'),USE(?TabOne)

       OPTION('Option 1'),USE(OptVar1),KEY(F10Key),HLP('Option1Help')

        RADIO('Radio 1'),AT(20,0,20,20),USE(?R1)

        RADIO('Radio 2'),AT(40,0,20,20),USE(?R2)

       END

       OPTION('Option 2'),USE(OptVar2),MSG('Option 2')

        RADIO('Radio 3'),AT(60,0,20,20),USE(?R3)

        RADIO('Radio 4'),AT(80,0,20,20),USE(?R4)

       END

       PROMPT('Enter Data:'),AT(100,100,20,20),USE(?P1)

       ENTRY(@S8),AT(100,140,32,20),USE(E1)

       PROMPT('Enter More Data:'),AT(100,200,20,20),USE(?P2)

       ENTRY(@S8),AT(100,240,32,20),USE(E2)

      END

      TAB('Tab Two'),USE(?TabTwo)

       OPTION('Option 3'),USE(OptVar3)

        RADIO('Radio 1'),AT(20,0,20,20),USE(?R5)

        RADIO('Radio 2'),AT(40,0,20,20),USE(?R6)

       END

       OPTION('Option 4'),USE(OptVar4)

        RADIO('Radio 3'),AT(60,0,20,20),USE(?R7)

        RADIO('Radio 4'),AT(80,0,20,20),USE(?R8)

       END

       PROMPT('Enter Data:'),AT(100,100,20,20),USE(?P3)

       ENTRY(@S8),AT(100,140,32,20),USE(E3)

       PROMPT('Enter More Data:'),AT(100,200,20,20),USE(?P4)

       ENTRY(@S8),AT(100,240,32,20),USE(E4)

      END

     END

     BUTTON('Ok'),AT(100,180,20,20),USE(?Ok)

     BUTTON('Cancel'),AT(200,180,20,20),USE(?Cancel)

    END

See Also:

SHEET

Extended UI

tab_declare_a_page_of_a_sheet_control_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)