| Prev | Next | Basic Verbs > setObj |
setObj
| Syntax |
setObj (class, container, keyForm, keyData)
|
| Params |
class is a string4 indicating the class of the object to be specified container is the specifier for the object that contains the object being specified keyForm is a string4 indicating the manner in which the object is to be specified keyData is a value specifying an object within container
|
| Action |
Creates an Apple event object specifier for an object within container of the given class, according to the keyForm and keyData parameters. The keyData is interpreted according to keyForm, as follows: If keyForm is 'name', keyData is interpreted as a string that is the name of the object If keyForm is 'indx', keyData is interpreted as a number, that is the index of the object among other objects of its class within container. If keyForm is 'prop', keyData is interpreted as a string4 that is the property id of the object If keyForm is any other value, it is assumed to be a custom form, and keyData is included in object specifier as the type provided.
|
| Returns |
The resulting object specifier.
|
| Examples |
setObj ('cwin', 0, 'indx', 1) «see notes » (object specification)
This specifies the first window in an application. It is equivalent to the expression window [1].
This specifies the font property of the object specified by wordSpec. |
| Platform Notes |
This verb is only implemented in the Mac OS version of Frontier.
|
| Notes |
This is an advanced Frontier verb of primary interest to implementers and advanced scripters. It is not necessary to understand it to use Frontier effectively for most tasks. As illustrated in Example 1 above, the number zero can be used to represent the null object, which is the container for objects at the top of an application's container hierarchy. Frontier's new object specifier syntax supersedes the basic functionality of this verb, which was used to build simple object specifiers in version 1.0. However, setObj is still useful in creating specialized specifiers that use custom key forms.
|
| See Also |
property
|
| Prev | Next | Basic Verbs > setObj |
