<string> tag
The <string> tag describes the screen based on a string. The attributes of the <string> tag are:
- value
- The string value. This value can contain any valid Unicode character. This is a required attribute.
- row
- The starting row position for a string at an absolute position
or in a rectangle. The value must be a number or an expression that
evaluates to a number. This value is optional. If not specified, Macro
logic searches the entire screen for the string. If specified, col
position is required. <erow> and <ecol> attributes can also
be specified to specify a string in a rectangular area.
Note: Negative values are valid and are used to indicate relative position for the bottom of the screen (for example, -1 is the last row).
- col
- The starting column position for the string at an absolute position or in a rectangle. The value must be a number or an expression that evaluates to a number. This attribute is optional.
- erow
- The ending row position for string in a rectangle. The value must be a number or an expression that evaluates to a number. This attribute is optional. If both erow and ecol are specified, string is in a rectangle.
- ecol
- The ending column position for string in a rectangle. The value must be a number or an expression that evaluates to a number. This attribute is optional. If both erow and ecol are specified, string is in a rectangle.
- casesense
- If true, string comparison is case sensitive. The value must be true or false or an expression that evaluates to true or false. This attribute is optional. The default is false.
- optional
- If false, this descriptor is considered non-optional during screen recognition. If the descriptors contain more than one non-optional descriptor, and more than one optional descriptor, the non-optional descriptors are checked first. If all of the non-optional descriptors match, the screen matches. If at least one of the non-optional descriptors does not match, the optional descriptors are checked. One of the optional descriptors must match for the screen to match. Otherwise, the screen fails to match. The value must be true or false or an expression that evaluates to true or false. This attribute is optional. The default is false.
- invertmatch
- If true, recognition matching passes only if the screen does not match this description element (boolean not operation). The value must be true or false or an expression that evaluates to true or false. This attribute is optional. The default is false.