Class

# AppleEventDescList

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

## Description

Used to send complex information to other applications via AppleEvents.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                              | Type                               | Read-Only | Shared |
|-----------------------------------|------------------------------------|-----------|--------|
| `Count<appleeventdesclist.count>` | `Integer</api/data_types/integer>` | ✓         |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                                              | Parameters                                                                 | Returns                                                           | Shared |
|-------------------------------------------------------------------|----------------------------------------------------------------------------|-------------------------------------------------------------------|--------|
| `AppendBoolean<appleeventdesclist.appendboolean>`                 | b As `Boolean</api/data_types/boolean>`                                    |                                                                   |        |
| `AppendDescList<appleeventdesclist.appenddesclist>`               | Value As AppleEventDescList                                                |                                                                   |        |
| `AppendFolderItem<appleeventdesclist.appendfolderitem>`           | Value As `FolderItem</api/files/folderitem>`                               |                                                                   |        |
| `AppendInteger<appleeventdesclist.appendinteger>`                 | Value As `Integer</api/data_types/integer>`                                |                                                                   |        |
| `AppendObjectSpecifier<appleeventdesclist.appendobjectspecifier>` | Value As `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` |                                                                   |        |
| `AppendRecord<appleeventdesclist.appendrecord>`                   | Value As `AppleEventRecord</api/macos/appleeventrecord>`                   |                                                                   |        |
| `AppendString<appleeventdesclist.appendstring>`                   | Value As `String</api/data_types/string>`                                  |                                                                   |        |
| `BooleanItem<appleeventdesclist.booleanitem>`                     | Index As `Integer</api/data_types/integer>`                                | `Boolean</api/data_types/boolean>`                                |        |
| `DescListItem<appleeventdesclist.desclistitem>`                   | Index As `Integer</api/data_types/integer>`                                | AppleEventDescList                                                |        |
| `FolderItemItem<appleeventdesclist.folderitemitem>`               | Index As `Integer</api/data_types/integer>`                                | `FolderItem</api/files/folderitem>`                               |        |
| `IntegerItem<appleeventdesclist.integeritem>`                     | Index As `Integer</api/data_types/integer>`                                | `Integer</api/data_types/integer>`                                |        |
| `ObjectSpecifierItem<appleeventdesclist.objectspecifieritem>`     | Index As `Integer</api/data_types/integer>`                                | `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` |        |
| `RecordItem<appleeventdesclist.recorditem>`                       | Index As `Integer</api/data_types/integer>`                                | `AppleEventRecord</api/macos/appleeventrecord>`                   |        |
| `StringItem<appleeventdesclist.stringitem>`                       | Index As `Integer</api/data_types/integer>`                                | `String</api/data_types/string>`                                  |        |

## Property descriptions

<div id="appleeventdesclist.count">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.Count

**Count** As `Integer</api/data_types/integer>`

> The number of items in the list.
>
> This property is read-only.

## Method descriptions

<div id="appleeventdesclist.appendboolean">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendBoolean

**AppendBoolean**(b As `Boolean</api/data_types/boolean>`)

> Adds a new `Boolean</api/data_types/boolean>` value to the array.

<div id="appleeventdesclist.appenddesclist">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendDescList

**AppendDescList**(Value As AppleEventDescList)

> Adds a new <span class="title-ref">AppleEventDescList</span> value to the array.

<div id="appleeventdesclist.appendfolderitem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendFolderItem

**AppendFolderItem**(Value As `FolderItem</api/files/folderitem>`)

> Adds a new `FolderItem</api/files/folderitem>` object to the array.

<div id="appleeventdesclist.appendinteger">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendInteger

**AppendInteger**(Value As `Integer</api/data_types/integer>`)

> Adds a new `Integer</api/data_types/integer>` value to the array.

<div id="appleeventdesclist.appendobjectspecifier">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendObjectSpecifier

**AppendObjectSpecifier**(Value As `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>`)

> Adds a new `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>` object to the array.

<div id="appleeventdesclist.appendrecord">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendRecord

**AppendRecord**(Value As `AppleEventRecord</api/macos/appleeventrecord>`)

> Adds a new `AppleEventRecord</api/macos/appleeventrecord>` object to the array.

<div id="appleeventdesclist.appendstring">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.AppendString

**AppendString**(Value As `String</api/data_types/string>`)

> Adds a new `String</api/data_types/string>` to the array.

<div id="appleeventdesclist.booleanitem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.BooleanItem

**BooleanItem**(Index As `Integer</api/data_types/integer>`) As `Boolean</api/data_types/boolean>`

> Returns the *Index* item as a `Boolean</api/data_types/boolean>`.

<div id="appleeventdesclist.desclistitem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.DescListItem

**DescListItem**(Index As `Integer</api/data_types/integer>`) As AppleEventDescList

> Returns the *Index* item as an <span class="title-ref">AppleEventDescList</span>.

<div id="appleeventdesclist.folderitemitem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.FolderItemItem

**FolderItemItem**(Index As `Integer</api/data_types/integer>`) As `FolderItem</api/files/folderitem>`

> Returns the *Index* item as a `FolderItem</api/files/folderitem>`.

<div id="appleeventdesclist.integeritem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.IntegerItem

**IntegerItem**(Index As `Integer</api/data_types/integer>`) As `Integer</api/data_types/integer>`

> Returns the *Index* item as an `Integer</api/data_types/integer>`.

<div id="appleeventdesclist.objectspecifieritem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.ObjectSpecifierItem

**ObjectSpecifierItem**(Index As `Integer</api/data_types/integer>`) As `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>`

> Returns the *Index* item as an `AppleEventObjectSpecifier</api/macos/appleeventobjectspecifier>`.

<div id="appleeventdesclist.recorditem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.RecordItem

**RecordItem**(Index As `Integer</api/data_types/integer>`) As `AppleEventRecord</api/macos/appleeventrecord>`

> Returns the *Index* item as an `AppleEventRecord</api/macos/appleeventrecord>`.

<div id="appleeventdesclist.stringitem">

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

</div>

<div class="rst-class">

forsearch

</div>

AppleEventDescList.StringItem

**StringItem**(Index As `Integer</api/data_types/integer>`) As `String</api/data_types/string>`

> Returns the *Index* item as a `String</api/data_types/string>`.

## Sample code

In this code, the TextEdit application (which must be running for this example to work) is instructed to open two documents ("My Document" and "My Other Document") that are located in the folder with the default folder:

``` xojo
Var list As AppleEventDescList

list = New AppleEventDescList
list.AppendFolderItem(New FolderItem("My Document", FolderItem.PathModes.Native))
list.AppendFolderItem(New FolderItem("My Other Document", FolderItem.PathModes.Native))

Var a As AppleEvent = New AppleEvent("aevt", "odoc", "com.apple.textedit")
a.DescListParam("----") = list

If Not a.Send Then
  MessageBox("The AppleEvent could not be sent.")
End If
```

## Compatibility

|                       |                       |
|-----------------------|-----------------------|
| **Project Types**     | Console, Desktop, Web |
| **Operating Systems** | macOS                 |

<div class="seealso">

`Object</api/data_types/additional_types/object>` parent class; `AppleEvent</api/macos/appleevent>`, `AppleEventRecord</api/macos/appleeventrecord>` classes.

</div>