Tests the Outline tree for an object matching the given criteria. Searches only non-ambiguous objects given the current selection.
<object
type="group_name"
state="{any | stateless | fully-defined | under-defined | suppressed |
not-updated | updated | obsolete | error | bad-license}"
name-regexp="regular_expression"
condition="{exists | does-not-exist | is-selected | is-not-selected}" />Note: It was necessary to "word wrap" the long line of code in the above example.
Attributes
type
Optional. Identifies an object group name or an object type constant as a search criteria. If omitted, the object type is not considered.
Object groups are defined by using the object-group element. Refer to the Standard Object Groups Reference.
Type constants for specific objects (prefixed by "id_") are defined in the script file DSConstants.js.
state
Optional. Specifies an object state as a search criteria. If omitted, the default of "any" is used, meaning that object state is not considered.
States are defined in the script file DSConstants.js.
name-regexp
Optional. Specifies a regular expression of an object's name as a search criteria. For example, "part" matches any object that includes "part" in its name (e.g. "part 2"). If omitted, object names are not considered. See the Microsoft regular expressions reference .
condition
Specifies a condition to test.
| exists | Returns true if an object matching the criteria exists. |
| does-not-exist | Returns true if no object matches the criteria. |
| is-selected | Returns true if an object matching the criteria is currently selected. |
| is-not-selected | Returns true if no object matching the criteria is currently selected. |