FormRun.tabOrder Method

Specifies the order in which you navigate to form controls when you press the TAB key.

Syntax

public Array tabOrder([Array newValue])

Run On

Client

Parameters

  • newValue
    Type: Array Class
    An Array object that specifies the order of form controls; optional.

Return Value

Type: Array Class
An Array object of integer elements.

Remarks

You must call the FormRun.run method before you call the tabOrder method; otherwise, the system is disabled.

Examples

The following example shows a call to the tabOrder method to return an Array object that specifies the order of the form controls. The Array.toString method prints the form control IDs.

void runForm(Form form) 
{ 
    Args args; 
    FormRun formRun; 
    int handle; 
    Array tabOrder; 
  
    args = new Args(); 
    args.object(form); 
    tabOrder = new Array(Types::Container); 
 
    // Create the run-time form. 
    formRun = new FormRun(Args); 
    formRun.run(); 
    formRun.detach(); 
 
    tabOrder = formRun.tabOrder(); 
    print tabOrder.toString(); 
    pause; 
}

See Also

FormRun Class

Arrays