SetUpTabs Method (TABCONTROL)

10.3A, PLBCMP GUI Only

The SetUpTabs method replaces all of the tabs for a TABCONTROL object. This method simplifies the initialization of TABCONTROL tabs labels with a single operation. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A TABCONTROL object that is modified.

return

Optional. A Numeric Variable that always returns a zero value.

labels

Required. A Character String Variable or literal that contains one or more tab labels that are added the TABCONTROL.

options

Optional. A Numeric Variable or decimal number that specifies a bit mask value that controls the behaviors of this method. This parameter is implemented for future use.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. The ZERO flag is always set as the return value is always zero.

2. The OVER and EOS flags are set to FALSE.

3. The processing of the SetupTabs method is implemented as two operations as follows:

 

• All of the current TABCONTROL tabs are deleted.

• All tab labels specified in the {labels} parameter are used to add tab(s) to the TABCONTROL object.

 

4. The {labels} string can be specified as a NULL string or it can contain one or more labels processed as follows:

 

Label String	Descriptions
NULL	All of the TABCONTROL tabs are deleted.
label1	After all of the tabs are deleted, one tab is added.
label1;label2;...	After all of the tabs are deleted, multiple tabs with labels are added.

 

5. The {options} value is a bit-mask value that is used for future usage.

Examples:

TC1 TABCONTROL

TC2 TABCONTROL

NULL DIM 1

ONETABS INIT "Main"

TWOTABS INIT "&Documents;&Images"

.

           TC1.SetupTabs USING ONETAB //One tab named 'Main'

 .

           TC2.SetupTabs USING TWOTABS //Two tabs named 'Document' and 'Images'

See Also: Method Syntax, TABCONTROL Methods