The CursorHomeColumn and CursorHomeRow are active in three different modes. In each case the cursor location is used to offset how recognition works, in relation to the cursor.
1.Standard Mode
2.Floating Window Mode
3.TTYPrompt Mode
When using this property set this value to the Cursor's "home" column position, which is the position found in the screen property active in the Screen Definition. This is usually visible and can be set by right-clicking on the cursor and selecting to set the value.
Standard Mode
Standard mode is when the FloatingWindow navigation boolean is false and the TTYPrompt VT recognition option is false
To hold recognition until it is ready, set this value to the Cursor's "home" column position.
In some environments, particularly character mode VT100 environments, recognition may need the cursor location in order to avoid "early recognition" of a screen. This is particularly troublesome when there is a pause during a screen transition and the current screen may be in the recognition list: the current screen will be recognized, even though the only thing that has happened is that the cursor may have moved one position to the right.
If you find that recognition is being "tripped-up" in a VTxxx emulation, you can use this value to ensure that recognition will wait for the cursor to "settle" to the home position.
Note: In standard mode, the CursorHomeColumn and CursorHomeRow properties should not be used on screens where the cursor may start in more than one position, unless there is a ScreenDefinition for each condition/cursor home location.
If only the CursorHomeColumn is defined, then any cursor position in that column will provide recognition; this is a good approach if rows may be inserted based on active data or the user's security profile. |
Floating Window Mode
When Floating Window mode is active (PopupWindow = true and FloatingWindow = true), the recognition is offset from the starting cursor location when a screen is displayed. This allows recognition for pop-up window overlays that can move in position (but still be the same window in terms of field data).
TTYPrompt Mode
A VT-style host (character mode) has a property that can be set on the screen definition to indicate that it is a simple prompt. CursorHomeColumn has a very special use in this mode. For most cases, leave it zero to have recognition always be offset by the active row only (CursorHomeRow is always required for TTYPrompt mode). If there is variable text at the beginning of the prompt, however, set CursorHomeColumn to the column found in the recording screen's cursor location. Then be sure to have recognition set to "hug" the cursor (right justified) and avoid any variable text in the recognition element(s).
