A Cursor Position descriptor is evaluated as true if the cursor
position specified in the descriptor is equal to the position of the text
cursor in the currently displayed application screen.
To create a Cursor Position descriptor, follow these steps:
- Right-click the screen description to which you want to add the descriptor.
- Click .
Note: Alternatively,
instead of
doing steps 1 and 2, you can do the following:
- On the Screen Descriptions tab, click the screen description to which
you want to add the descriptor.
- Click on the menu bar of the workbench.
- The Cursor Position descriptor is created. The Position property is initially
set to the position of the text cursor at the time the application screen
was captured.
You can modify the properties displayed in the Properties view:
- Select the property that you want to modify.
- Type or select the value that you want the property to have.
Also, for the Position property, you can use the marking rectangle displayed
in the screen image on the right side of the Screen Descriptors tab:
- When you click Add Cursor Position Descriptor,
the screen message editor displays a dotted green marking rectangle around
the character position specified by the Position property.
- Drag the marking rectangle so that it marks the position that you want
to use.
- To clear the marking rectangle, click once over the screen image.
- To make the marking rectangle appear again, click once over the screen
image.
Table 1 lists
each property and its significance:
Table 1. Cursor descriptor| Property: |
Significance: |
| Invert Match |
After the descriptor has been evaluated as true or false
with respect to the currently displayed application screen, the value of the
Invert Match property is checked:- If the Invert Match value is true, then the boolean result obtained by
evaluating the descriptor is inverted, changing true to false or false to
true.
- If the Invert Match value is false, then the boolean result is not inverted.
|
| Position |
The offset of the text cursor from the upper left corner
of the currently displayed application screen. This offset is calculated from
the (Row, Column) position of the character as follows: Offset = ((Row-1)*RowSize)+Column
For
example, assuming that the screen is 25 rows by 80 columns, then the offset
of the character at Row 3, Column 1 of the application screen is:Offset = ((3-1)*80)+1
= 161
|