CIP C++ documentation for class "pfcSelections"

Class pfcSelections

# include <pfcSelect.h> class pfcSelections : public xobject { xdeclare(pfcSelections) ... }; This is a COMPACT class.

Description

This data type is used to specify an array of selections.

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.

Manual References:: Annotations: Annotation Features and Annotations: Ordinate Dimensions, Geometry Evaluation: Tracing a Ray, Solid Bodies: To create an assembly from a multibody part, Overview of Creo Object TOOLKIT C++: Casting of Creo Object TOOLKIT C++ pfc Classes to wfc Classes, Curve and Surface Collection: The wfcCollection Interface

Method Summary


`void`	`append (optional pfcSelection_ptr value)`
	Appends an element with the specified value to the end of the sequence.

`void`	`clear ()`
	Removes all the elements from the sequence.

`static pfcSelections *`	`create ()`
	Creates a new empty sequence.

`static pfcSelections *`	`createCapacity (xint count)`
	Creates a new empty sequence with a specified initial capacity. Capacity is the number of elements, that can be added to the sequence without having to reallocate its internal buffers.

`optional pfcSelection_ptr`	`get (xint idx)`
	Returns the value of the sequence element with the specified index. If the index is out of range, this method throws exception `cipXInvalidSeqIndex`.

`xint`	`getarraysize ()`
	Returns current number of elements in the sequence.

`void`	`insert (xint idx, optional pfcSelection_ptr 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 (xint idx, xtbsequence<pfcSelection_ptr> *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 (xint frominc, xint 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 (xint idx, optional pfcSelection_ptr 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

xint getarraysize ()

Returns current number of elements in the sequence.

Returns:: Current number of elements.

optional pfcSelection_ptr get (xint 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.

void set (xint idx, optional pfcSelection_ptr 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:

void removerange (xint frominc, xint 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:

void append (optional pfcSelection_ptr value)

Appends an element with the specified value to the end of the sequence.

Parameters:

value: Value to be appended.

Returns:

void insert (xint idx, optional pfcSelection_ptr 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:

void insertseq (xint idx, xtbsequence<pfcSelection_ptr> *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:

void clear ()

Removes all the elements from the sequence.

Returns:

static pfcSelections * create ()

Creates a new empty sequence.

Returns:: Created sequence.

static pfcSelections * createCapacity (xint count)

Creates a new empty sequence with a specified initial capacity. Capacity is the number of elements, that can be added to the sequence without having to reallocate its internal buffers.

Parameters:

count

Returns:: Created sequence.