CIP JavaScript documentation for sequence " pfcModelItems"

Class pfcModelItems

Description

Specifies a list of model items.

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 ( pfcModelItem Item )`
	Adds a new item to the end of the sequence.
`void`	`Clear ( )`
	Removes all items from the sequence.
`void`	`Insert ( number AtIndex , pfcModelItem 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 , pfcModelItems 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.
`pfcModelItem`	`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 , pfcModelItem 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 ( pfcModelItem Item )

Adds a new item to the end of the sequence.

void Clear ( )

Removes all items from the sequence.

void Insert ( number AtIndex , pfcModelItem 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 , pfcModelItems 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.

pfcModelItem 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 , pfcModelItem 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.