Please enable JavaScript to view this site.

R:BASE 11 Help

Navigation: Command Index > S

SKIP

Scroll Prev Top Next More

Use the SKIP command in an entry/exit procedure (EEP) to automatically skip fields in a form.

 

SKIP

 

Options

 

n

Specifies the number of fields you want to skip, where n is a positive or negative integer. Use positive numbers to move forward through the field order in the form, and negative numbers to move backward. When you establish a value for n, count only those fields that allow you to enter or edit data.

 

SKIP 0 returns you to the same field you were in.

 

TO fldname

Specifies the field to which you want to skip, either forward or backward through the field order, where fldname is the column or variable name associated with a field.

 

About the SKIP Command

 

When an EEP is run, SKIP moves backward or forward through the fields in a form. SKIP operates within a form like the [Tab] key-it does not move to fields other than those in the current row or current table. You can use SKIP only in an EEP within a form.

 

This command is useful when you want to skip over certain fields in the form, depending on the data entered. A variable must always be associated with a field. You can set up an EEP to check the value entered in the field's variable, and then, depending on the value, skip to another field.

 

Notes:

 

SKIP TO Fldname or SKIP n when used in a Tab Form will ONLY be applicable to that Tab (e.g., page) of the Tab Control. Therefore, you CANNOT use SKIP command to switch from any field on one page of the Tab Control to another page of the Tab Control. A Tab (page) of the tab control is similar to a "container". Thus, the SKIP command will ONLY work with objects on the same page of the Tab Control.

 

The SKIP n command will base the field numbers to skip to based upon the [Tab] / [Shift]+[Tab] movement of the cursor, not the mouse. If you want to ensure the focus will land on a specific field, whether the user presses keys on the keyboard or uses the mouse, you can use SKIP TO Fldname or the PROPERTY command.

 

You may also use the PROPERTY command as such; PROPERTY <ComponentID> SET_FOCUS 'TRUE' to achieve the same functionality.

 

 

Examples

 

The following commands cause a form to skip three fields if the vcashtype variable contains any value.

 

IF vcashtype IS NOT NULL THEN

SKIP 3

ENDIF

 

The following commands cause a form to skip to the field containing the amount column if the vcashtype variable contains any value.

 

IF vcashtype IS NOT NULL THEN

SKIP TO amount

ENDIF