#include <MItSelectionList.h>
Iterate over the items in the selection list.
Class for iterating over the items in an MSelection list. A filter can be specified so that only those items of interest on a selection list can be obtained.
If a filter is specified then the children of DAG selection items will be searched if the selection item does not match the filter. For example, if filter = MFn::kNurbsCurve and a transform is selected then the underlying shape for the transform will be in the iteration if it is a nurbs curve.
Example: (of a simple traversal)
Example: (of a traversal to find all active cameras)
Public Types | |
enum | selItemType { , kDagSelectionItem, kAnimSelectionItem, kDNselectionItem, kPlugSelectionItem } |
Types of items which can appear on a selection list. More... | |
Public Member Functions | |
bool | isDone (MStatus *ReturnStatus=NULL) |
Specifies whether or not there is anything more to iterator over. More... | |
MStatus | next () |
Advance to the next item. More... | |
MStatus | reset () |
Reset the iterator. More... | |
MStatus | getDependNode (MObject &depNode) |
This method retrieves the dependency node of the current selection item. More... | |
MStatus | getDagPath (MDagPath &dagPath, MObject &component) |
This method retrieves the dag path and the components of the current selection item. More... | |
MStatus | getDagPath (MDagPath &dagPath) |
This method retrieves the dag path of the current selection item. More... | |
MStatus | getPlug (MPlug &plug) |
This method retrieves the plug of the current selection item. More... | |
MStatus | getStrings (MStringArray &array) |
Get the string representation of the current item in the selection list. More... | |
selItemType | itemType (MStatus *ReturnStatus=NULL) |
Returns the current selection item type. More... | |
MStatus | setFilter (MFn::Type filter) |
Apply a filter to the iteration. More... | |
bool | hasComponents (MStatus *ReturnStatus=NULL) const |
Returns whether or not the current selection item has components. More... | |
MItSelectionList (const MSelectionList &list, MFn::Type=MFn::kInvalid, MStatus *ReturnStatus=NULL) | |
Class constructor. More... | |
virtual | ~MItSelectionList () |
Class destructor. More... | |
Static Public Member Functions | |
static const char * | className () |
Returns the name of this class. More... | |
enum selItemType |
OPENMAYA_MAJOR_NAMESPACE_OPEN MItSelectionList | ( | const MSelectionList & | list, |
MFn::Type | filter = MFn::kInvalid , |
||
MStatus * | ReturnStatus = NULL |
||
) |
Class constructor.
Creates a iterator for the given selection list.
NOTE: this class iterates on a copy of the given list and so any changes to the original list will not be reflected upon in this iterator.
[in] | list | The selection list to iterate over |
[in] | filter | Type filter |
[out] | ReturnStatus | Status code |
|
virtual |
Class destructor.
Removes internal iterator data.
bool isDone | ( | MStatus * | ReturnStatus = NULL | ) |
Specifies whether or not there is anything more to iterator over.
[out] | ReturnStatus | Status code |
MStatus next | ( | ) |
Advance to the next item.
If components are selected then advance to next component.
If a filter is specified then the next item will be one that matches the filter.
MStatus reset | ( | ) |
Reset the iterator.
If a filter has been specified then the current item will be the first selected item that matches the filter.
This method retrieves the dependency node of the current selection item.
[out] | depNode | a pointer the the dependency node to be retrieved Returns kNullObj and kFailure if components are selected or selected item does not contain a dependency node. |
This method retrieves the dag path and the components of the current selection item.
If components are not selected then NULL is assigned to the component pointer.
[out] | dagPath | The dag path of the current selection item. |
[out] | component | A pointer to the selected components of the current selection item. |
This method retrieves the dag path of the current selection item.
[out] | dagPath | The dag path of the current selection item. |
This method retrieves the plug of the current selection item.
[out] | plug | The plug of the current selection item. |
MStatus getStrings | ( | MStringArray & | array | ) |
Get the string representation of the current item in the selection list.
It is possible that it will require more than one string to represent the item (the item may contain groups of CVs for example), so a string array is used to pass back the results.
[out] | array | Storage for the returned array. |
MItSelectionList::selItemType itemType | ( | MStatus * | ReturnStatus = NULL | ) |
Returns the current selection item type.
[out] | ReturnStatus | Status code |
Apply a filter to the iteration.
Selection items not matching the filter type will be excluded from the iteration.
[in] | filter | The MFn::Type that you will be included in the iteration. See MFn.h for possible types. |
bool hasComponents | ( | MStatus * | ReturnStatus = NULL | ) | const |
Returns whether or not the current selection item has components.
[out] | ReturnStatus | Status code |
|
static |
Returns the name of this class.