Method

# GetTestObjectDescriptor

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Description

Returns an `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` built to perform some kind of test.

## Usage

``` xojo
result = GetTestObjectDescriptor(DesiredClass, ObjectSpecifier, Comparison)
```

| Part            | Type                                                              | Description                                                                          |
|-----------------|-------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| result          | `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` | The object that was created.                                                         |
| DesiredClass    | `String</api/data_types/string>`                                  | The class of `AppleEvent</api/macos/appleevent>` object you are looking for.         |
| ObjectSpecifier | `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` | The source object. Pass `Nil</api/language/nil>` to search at the application level. |
| Comparison      | `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` | The object describing the actual test to be performed.                               |

## Notes

At present, `GetStringComparisonObjectDescriptor</api/macos/getstringcomparisonobjectdescriptor>` is the only function that returns an `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` describing a test, but this will probably be extended in the future.

## Compatibility

|                       |         |
|-----------------------|---------|
| **Project Types**     | Desktop |
| **Operating Systems** | macOS   |

<div class="seealso">

`AppleEvent</api/macos/appleevent>` class; `GetIndexedObjectDescriptor</api/macos/getindexedobjectdescriptor>`, `GetNamedObjectDescriptor</api/macos/getnamedobjectdescriptor>`, `GetOrdinalObjectDescriptor</api/macos/getordinalobjectdescriptor>`, `GetPropertyObjectDescriptor</api/macos/getpropertyobjectdescriptor>`, `GetRangeObjectDescriptor</api/macos/getrangeobjectdescriptor>`, `GetStringComparisonObjectDescriptor</api/macos/getstringcomparisonobjectdescriptor>` functions.

</div>