Ets_Model_Selected_Get()
Abstract
Gets the nth selected object in the specified model.
Syntax
Ets_Model_Selected_Get (mdl_hndl, index)
| Argument | Type | Description |
|---|---|---|
mdl_hndl |
EtsT_Model_Handle |
Model containing the selected objects of interest. |
index |
int |
Numerical index of the desired object in the selection set. |
Return Type
EtsT_Obj_handle
Handle to the nth selected object (where n is given by index)
Header
ets_api_model.h
Details
Returns a handle to the nth object in the set of selected objects in the specified model, where the argument index specifies n.
If index is out of range, the invalid object is returned.
Be aware that insertions and deletions to the set of selected objects may change the count of selected objects and the index of a given model in the set. However, only those objects at a larger index than the inserted or deleted object will be affected. For that reason, you might want to iterate backwards if you are deleting objects.