Language Guide

CHAPTER 5

Objects and References

130 Reference Forms

NOTES

Except for the Every Element reference form, the application returns an error

if no objects pass the test or tests. For the Every Element reference form, the

application returns an empty list if no objects pass the test or tests.

To specify a container after a ﬁlter, you must enclose the ﬁlter and the

reference it applies to in parentheses. For example, the parentheses around

words 1 thru 5 whose first character = "M" in the following

reference are required because the container of paragraph 5 follows

the ﬁlter.

(words 1 thru 5 whose first character = "M") of paragraph 5

ID 5

The ID reference form speciﬁes an object by the value of its ID property. You

can use this reference form only for objects that have an ID property.

SYNTAX

className id IDvalue

where

className is the class identiﬁer for the speciﬁed object.

IDvalue is the value of the object’s ID property.

EXAMPLES

document ID 9096

window id 777

NOTES

Although ID properties are most often integers, an ID property can belong

to any class. An application that includes ID properties must guarantee that

the IDs are unique within a container. Some applications may also provide