GetOrdinalObjectDescriptor Function

Returns an AppleEventObjectSpecifier that is within another AppleEventObjectSpecifier. The AppleEventObjectSpecifier is found by class and an ordinal key.

Syntax
result = GetOrdinalObjectDescriptor( DesiredClass, Object, OrdinalKey )

Parameters
DesiredClass | String | Indicates the class of AppleEvent object you are looking for.
Object | AppleEventObjectSpecifier | The source object. Pass Nil to search at the application level.
OrdinalKey | String | The scope to use when searching.

Return Value
Result | AppleEventObjectSpecifier | The object that was found.

# Notes

The ordinal keys are:

Key | Description
--- | ---
firs | First
last | Last
midd | Middle
any | Any
all | All

Ordinal keys are four characters so the "any" and "all" keys have a space following them.

# Example

This example asks the Finder for a count of the currently running processes:

Dim a as AppleEvent
Dim i, count as Integer
a = NewAppleEvent("core", "cnte", "MACS")
a.MacTypeParam("kocl") = "prcs"
a.ObjectSpecifierParam("----") = GetOrdinalObjectDescriptor("prcs", nil, "all ")
If a.Send then
count = Val(a.ReplyString)
End if

# See Also

AppleEvent class; GetIndexedObjectDescriptor, GetNamedObjectDescriptor, GetPropertyObjectDescriptor, GetRangeObjectDescriptor, GetStringComparisonObjectDescriptor, GetTestObjectDescriptor functions.