Method

GetOrdinalObjectDescriptor

---

Description

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

Usage

result = GetOrdinalObjectDescriptor(DesiredClass, Object, OrdinalKey)

Part	Type	Description
result	AppleEventObjectSpecifier	The object that was found.
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.

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.

Sample code

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

Var a As AppleEvent
Var i, count As Integer
a = New AppleEvent("core", "cnte", "com.apple.finder")
a.MacTypeParam("kocl") = "prcs"
a.ObjectSpecifierParam("----") = GetOrdinalObjectDescriptor("prcs", Nil, "all ")
If a.Send Then
  count = a.ReplyString.ToDouble
End If

Compatibility

All project types on all supported operating systems.

See also

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