InDesign2026
API 21.5.1.73
Collection of Sound

Sounds

A collection of sound clips.

Properties

NameType AccessDescription
Number readonly The number of objects in the collection.

Methods

Sound

Returns the Sound with the specified index.

index Number The index.
Sound

Creates a new Sound

layer? Layer The layer on which to create the Sound.
at? LocationOptions The location at which to insert the Sound relative to the reference object or within the container object.
reference? Document | Layer | MasterSpread | Page | Spread | PageItem The reference object. Note: Required when the at parameter is before or after. Can accept: Document, Spread, MasterSpread, Page, Layer or PageItem.
withProperties? Object Initial values for properties of the new Sound
Sound

Returns any Sound in the collection.

Number

Displays the number of elements in the Sound.

Sound[]

Returns every Sound in the collection.

Sound

Returns the first Sound in the collection.

Sound

Returns the Sound with the specified index or name.

index LongInteger | String The index or name. Can accept: Long Integer or String.
Sound

Returns the Sound with the specified ID.

id Number The ID.
Sound

Returns the Sound with the specified name.

name String The name.
Sound[]

Returns the Sounds within the specified range.

from LongInteger | Sound | String The Sound, index, or name at the beginning of the range. Can accept: Sound, Long Integer or String.
to LongInteger | Sound | String The Sound, index, or name at the end of the range. Can accept: Sound, Long Integer or String.
Sound

Returns the last Sound in the collection.

Sound

Returns the middle Sound in the collection.

Sound

Returns the Sound whose index follows the specified Sound in the collection.

obj Sound The Sound whose index comes before the desired Sound.
Sound

Returns the Sound with the index previous to the specified index.

obj Sound The index of the Sound that follows the desired Sound.
String

Generates a string which, if executed, will return the Sound.

Object of 6

Properties elsewhere that hold a Sounds.

Parameter of 1

Method parameters that accept a Sounds.