| **Navigation:**  [[introduction.htm|Language Reference]] > 8 - Controls > Control Declarations >====== TAB (declare a page of a SHEET control) ====== | [[string  declare a string control .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[text  declare a multi line text control .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

{{newc7.jpg|NewC7.jpg}}

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

|  | [,**COLOR()**] [,**FONT()**][,**HIDE**] |
| //controls// |  |
| **END** |  |

{{blk2blue.jpg|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  declare a group of tab controls .htm|SHEET]]

[[tpltabextendedui.htm|Extended UI]]