CIP C++ documentation for class "pfcSelectionBuffer"

Class pfcSelectionBuffer

# include <pfcSelect.h> class pfcSelectionBuffer : public virtual pfcChild { xaideclare(pfcSelectionBuffer) ... };

Description

This class represents a selection buffer, where items preselected by the user are stored to be used by tools and popupmenus.

Method Summary


`void`	`AddSelection (pfcSelection_ptr ToAdd)`
	Add an item to the selection buffer.

`void`	`Clear ()`
	Clear the selection buffer of all contents.

`optional pfcSelections_ptr`	`GetContents ()`
	Contents of the active selection buffer.

`void`	`RemoveSelection (xint IndexToRemove)`
	Removes the selection at the indicated location from the selection tool.

Methods Inherited from Class pfcChild:: GetDBParent, GetOId

Method Detail

optional pfcSelections_ptr GetContents ()

Contents of the active selection buffer.

Exceptions thrown (but not limited to):

pfcXToolkitCantAccess - There is no Object/Action selection tool active.

pfcXToolkitNotFound - There are no objects in the current selection tool.

Manual References:: Selection: Reading the Contents of the Selection Buffer, Selection: Removing the Items of the Selection Buffer

void AddSelection (pfcSelection_ptr ToAdd)

Add an item to the selection buffer.

Exceptions thrown (but not limited to):

pfcXToolkitCantAccess - There is no Object/Action selection tool active.

pfcXToolkitInvalidItem - The selection does not correctly reference the current model.

pfcXToolkitNotDisplayed - The item is not currently displayed and so cannot be added to the buffer.

pfcXToolkitBadContext - The selection cannot be added to the buffer in combination with one or more objects that are already in the buffer (e.g. geometry and features selected at the same time).

pfcXToolkitCantModify - Buffer modification is prohibited.

Manual References:: Selection: Adding Items to the Selection Buffer, Selection: Adding Items to the Selection Buffer

Parameters:

ToAdd: Selection to be added to the buffer.

Returns:

void RemoveSelection (xint IndexToRemove)

Removes the selection at the indicated location from the selection tool.

Exceptions thrown (but not limited to):

pfcXToolkitCantAccess - There is no Object/Action selection tool active.

pfcXToolkitCantModify - Buffer modification is prohibited.

Manual References:: Selection: Removing the Items of the Selection Buffer, Selection: Removing the Items of the Selection Buffer

Parameters:

IndexToRemove: Index of the item to remove from the currently active selection tool.

Returns:

void Clear ()

Clear the selection buffer of all contents.

Exceptions thrown (but not limited to):

pfcXToolkitCantAccess - There is no Object/Action selection tool active.

pfcXToolkitCantModify - Buffer modification is prohibited.

Manual References:: Selection: Removing the Items of the Selection Buffer

Returns: