VtLock(VTCL)

VtLock -- set cursor to watch cursor, lock out user input

Synopsis

VtLock

Description

Sets the cursor to the watch cursor and locks the application (that is, the application will no longer accept input from the user). New dialogs that are about to pop up are also automatically locked. To unlock the application, see VtUnLock(VTCL).

VtLock can be called multiple times. Calling VtUnLock will free all of the current locks. If you only wish to unlock one layer of the nested locks, use VtUnLock -once.

Return values

If VtLock fails, it returns one of the following error messages:

OPTION_COUNT: too many or too few options specified