# Items

The **Items** object lets you enumerate a collection of one or more [**Item**](item) objects. An **Items** object is retrieved from a number of methods and properties, including [**Dialog**](dialog)**.Multi**, [**DOpus**](dopus)**.GetClip**, [**Command**](command)**.files** and several others.

| Property Name      | Return Type                   | Description                                                                                                                                                                                                                                                                               |
| ------------------ | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| _\<default value>_ | _collection:_[**item**](item) | Returns a collection of [**item**](item) objects that you can enumerate.                                                                                                                                                                                                                  |
| result             | _bool_                        | When this **Items** object comes from the [**Dialog**](dialog)**.Multi** method, it includes a **result** property giving the result of the dialog. The collection of items is only valid if **result** returns **True**. If it returns **False** it means the user cancelled the dialog. |

| Method Name  | **Arguments** | Return Type | Description                                                                                                                                                                                                                                                                                                  |
| ------------ | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| RemoveNested | _none_        | _int_       | Removes any nested items from the collection (items that came from sub-folders rather than the root folder). The number of items removed is returned.                                                                                                                                                        |
| Update       | _none_        | _none_      | Updates the state of this object. This only applies to collections that come from certain sources (e.g. from a [**Tab**](tab)). When the **Items** object is first retrieved, a snapshot is taken. Changes made after that outside of the script will not be detected unless you call the **Update** method. |
