CIP JAVA documentation for class "com.ptc.uifc.uifcCore.Points"

Class Points

package com.ptc.uifc.uifcCore; public class Points implements jxobject

Description

An ordered collection of objects of a certain type.

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.

Method Summary
`static Points`	`create ()` Creates a new empty sequence.
`/optional/ Point`	`get (int idx)` Returns the value of the sequence element with the specified index. If the index is out of range, this method throws exception `cipXInvalidSeqIndex`.
`int`	`getarraysize ()` Returns current number of elements in the sequence.
`void`	`insert (int idx, /optional/ Point value)` Inserts an element with the specified value in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.
`void`	`insertseq (int idx, Points seq)` Inserts elements from the list passed as the second argument in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.
`void`	`removerange (int frominc, int toexcl)` Removes elements in the specified range from the sequence. The first argument specifies the index of the first element to be removed. The second argument specifies the index of the element immediately after the last in the range to be removed.
`void`	`set (int idx, /optional/ Point value)` Assigns a value to the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Method Detail

getarraysize

int getarraysize ()

Returns current number of elements in the sequence.

Returns:: Current number of elements.

get

/*optional*/ Point get (int idx)

Returns the value of the sequence element with the specified index. If the index is out of range, this method throws exception cipXInvalidSeqIndex.

Parameters:

idx: Index of requested sequence element.

Returns:: Value of the element at the specified index.

set

void set (int idx, /*optional*/ Point value)

Assigns a value to the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Parameters:

idx: Index of the element to be assigned.
value: Value to be assigned.

Returns:

removerange

void removerange (int frominc, int toexcl)

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

Parameters:

frominc: Index of the first element to be removed.
toexcl: Index of the element following the last element to be removed.

Returns:

insert

void insert (int idx, /*optional*/ Point value)

Inserts an element with the specified value in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Parameters:

idx: Index for an element to be inserted at.
value: Value to be inserted.

Returns:

insertseq

void insertseq (int idx, Points seq)

Inserts elements from the list passed as the second argument in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Parameters:

idx: Index at which the first new element should be inserted.
seq: Sequence of elements to be inserted.

Returns:

create

static Points create ()

Creates a new empty sequence.

Returns:: Created sequence.