SkipForm method

Applies to

Example

Description

Corresponds to selecting Form ð Skip in FORMS. The current form is skipped and Verify retrieves the next form. No confirmation message box is displayed when this method is executed.

This method can only be used in the FieldVerify, FormVerifyIdent, and FormVerifyUnident events.

Syntax

Object.SkipForm( SaveChanges )

Part

Data type

Description

Object

Object

An object expression that evaluates to an object in the Applies To list.

SaveChanges

Boolean

SaveChanges set to False causes Verify to discard any changes already made to the form. SaveChanges set to True causes Verify to save the form before getting the next one.

Settings

Return value

None.

Remarks

Only one form can be skipped at a time. If this method is called more than once from an event handler, all subsequent calls are ignored.

Important note: The SkipForm method only works correctly if you use the method in the very last line of code in your event handler (except the return value line). You cannot execute anything else after this method in your event handler.

In addition, when you call SkipForm in the FieldVerify event, the line immediately preceding the call (that is, the next-to-last line) must call SetReturnValue(0, "C").

Classic method

SkipForm