CIP JavaScript documentation for sequence " pfcActionSources"

Class pfcActionSources

Description

This type describes an array of action sources.

The user can access elements by their integer index (position) in the list. Sequence provides methods for positional (indexed) access to its elements. Sequences are zero based.

Property Summary


`/* readonly */ number`	`Count`

	Returns the number of items in the sequence.

Method Summary


`void`	`Append ( pfcActionSource Item )`
	Adds a new item to the end of the sequence.
`void`	`Clear ( )`
	Removes all items from the sequence.
`void`	`Insert ( number AtIndex , pfcActionSource Item )`
	Inserts a new item in front of the sequence item with the specified index. If the index is out of range, the sequence is expanded to include this index.
`void`	`InsertSeq ( number AtIndex , pfcActionSources Sequence )`
	Inserts a sequence of items passed as the second argument in front of the sequence item with the specified index. If the index is out of range, the sequence is expanded to include this index.
`pfcActionSource`	`Item ( number Index )`
	Accesses an item by its index in the sequence. If the index is out of range, this method throws the cipXInvalidSeqIndex exception.
`void`	`Remove ( number FromIndex , number ToIndex )`
	Removes items in the specified range from the sequence. The first argument specifies the index of the first item to be removed. The second argument specifies the index of the item immediately after the last in the range to be removed.
`void`	`Set ( number Index , pfcActionSource Item )`
	Assigns an item to the designated index in the sequence. If the index is out of range, the sequence is expanded to include this index.

Property Detail

/* readonly */ number Count

Returns the number of items in the sequence.

Method Detail

void Append ( pfcActionSource Item )

Adds a new item to the end of the sequence.

void Clear ( )

Removes all items from the sequence.

void Insert ( number AtIndex , pfcActionSource Item )

Inserts a new item in front of the sequence item with the specified index. If the index is out of range, the sequence is expanded to include this index.

void InsertSeq ( number AtIndex , pfcActionSources Sequence )

Inserts a sequence of items passed as the second argument in front of the sequence item with the specified index. If the index is out of range, the sequence is expanded to include this index.

pfcActionSource Item ( number Index )

Accesses an item by its index in the sequence. If the index is out of range, this method throws the cipXInvalidSeqIndex exception.

void Remove ( number FromIndex , number ToIndex )

Removes items in the specified range from the sequence. The first argument specifies the index of the first item to be removed. The second argument specifies the index of the item immediately after the last in the range to be removed.

void Set ( number Index , pfcActionSource Item )

Assigns an item to the designated index in the sequence. If the index is out of range, the sequence is expanded to include this index.