Enter data

Command group	Flag affected	Reversible	Execute on client	Platform(s)
Enter data	YES	NO	NO	All

Syntax

Description

This command puts Omnis into enter data mode which allows data to be entered via the current window. An error is generated if there is no open window. It initiates an internal control loop which does the following:

1. Places the cursor in the first entry field,
2. lets the user enter data from the keyboard,
3. Detects the use of Tab, Shift-Tab and other cursor movements such as click and moves the cursor to the appropriate field,
4. Waits for an OK, setting flag true before allowing control to pass to the command following Enter data in the method,
5. Detects a Cancel which aborts data entry with a false flag.

By default, the Enter data command waits for an evOK or evCancel event. When these events are triggered enter data mode is terminated (assuming the window is not in modeless enter data mode). However you can include a termination condition with Enter data which causes enter data mode to continue until the expression becomes true.

Example

# $construct of window class

Enter data
 
## ;  waits for a evOK or evCancel event

If flag true
  
OK message
 
{
User has pressed Return
}

Else
  
OK message
 
{
User has canceled
}

End If
 
# or

 
# $construct of window class

Calculate
 
iValue
 as 
0

Enter data
 
until 
iValue
>10
 
## waits for the user to enter a value greater than 10 into a entry field