MSelectionList Class Reference
 
 
 
MSelectionList Class Reference

#include <MSelectionList.h>


Class Description

A list of MObjects.

This class implements a list of MObjects.

The global selection list is a special case where the objects on the list are also active objects in Maya.

Besides the usual list methods, this class also provides an add method which retrieves objects from Maya, such as dependency nodes, by name.

Examples:

AbcExport/AbcExport.cpp, AbcExport/AbcWriteJob.cpp, AbcExport/AbcWriteJob.h, AbcExport/MayaCameraWriter.cpp, AbcExport/MayaMeshWriter.cpp, AbcImport/CreateSceneHelper.cpp, AbcImport/util.cpp, animExportUtil/animExportUtil.cpp, animImportExport/animImportExport.cpp, animInfoCmd/animInfoCmd.cpp, apiMeshShape/apiMeshShape.cpp, apiMeshShape/apiMeshShape.h, apiMeshShape/apiMeshShapeUI.cpp, apiMeshShape/apiMeshShapeUI.h, apiMeshShape/apiMeshSubSceneOverride.cpp, apiSimpleShape/apiSimpleShapeUI.cpp, apiSimpleShape/apiSimpleShapeUI.h, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomAnimLayers.h, atomImportExport/atomFileUtils.cpp, atomImportExport/atomFileUtils.h, atomImportExport/atomImportExport.cpp, atomImportExport/atomImportExport.h, atomImportExport/atomNodeNameReplacer.cpp, atomImportExport/atomNodeNameReplacer.h, blindComplexDataCmd/blindComplexDataCmd.cpp, blindDoubleDataCmd/blindDoubleDataCmd.cpp, blindShortDataCmd/blindShortDataCmd.cpp, cameraSetSubclass/testExCameraSetCmd.cpp, cameraSetSubclass/testExCameraSetCmd.h, cgfxAttrDef.cpp, cgfxShaderCmd.cpp, cgfxShaderCmd.h, cleanPerFaceAssignment/cleanPerFaceAssignmentCmd.cpp, closestPointCmd/closestPointCmd.cpp, closestPointOnCurve/closestPointOnCurveCmd.h, closestPointOnNurbsSurfaceCmd/closestPointOnNurbsSurfaceCmd.cpp, clothPaintAttrCmd/clothPaintAttrCmd.cpp, clusterWeightFunction/clusterWeightFunction.cpp, componentScaleManip/componentScaleManip.cpp, convertEdgesToFacesCmd/convertEdgesToFacesCmd.cpp, convertVerticesToEdgesCmd/convertVerticesToEdgesCmd.cpp, convertVerticesToFacesCmd/convertVerticesToFacesCmd.cpp, createClipCmd/createClipCmd.cpp, customAttrManip/customAttrManip.cpp, cvColorShader/cvColorShader.cpp, cvExpandCmd/cvExpandCmd.cpp, cvPosCmd/cvPosCmd.cpp, dagMessageCmd/dagMessageCmd.cpp, dagPoseInfoCmd/dagPoseInfoCmd.cpp, deletedMsgCmd/deletedMsgCmd.cpp, dx11Shader/dx11ShaderCmd.cpp, exportJointClusterDataCmd/exportJointClusterDataCmd.cpp, findFileTexturesCmd/findFileTexturesCmd.cpp, findTexturesPerPolygonCmd/findTexturesPerPolygonCmd.cpp, fluidInfoCmd/fluidInfoCmd.cpp, getAttrAffectsCmd/getAttrAffectsCmd.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheCmd.h, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheShapeNode.h, gpuCache/gpuCacheSubSceneOverride.cpp, helix2Cmd/helix2Cmd.cpp, hlslShader/hlslShader.cpp, hwAnisotropicShader_NV20/NodeMonitor.cpp, hwDecalBumpShader_NV20/NodeMonitor.cpp, hwReflectBumpShader_NV20/NodeMonitor.cpp, hwRefractReflectShader_NV20/NodeMonitor.cpp, hwToonShader_NV20/NodeMonitor.cpp, hwUnlitShader/NodeMonitor.cpp, instancerListCmd/instancerListCmd.cpp, intersectCmd/intersectCmd.cpp, intersectOnNurbsSurfaceCmd/intersectOnNurbsSurfaceCmd.cpp, lassoTool/lassoTool.cpp, latticeNoise/latticeNoiseCmd.cpp, lepTranslator/lepTranslator.cpp, lineManip/lineManip.cpp, lineManipContainer/lineManipContainer.cpp, listLightLinksCmd/listLightLinksCmd.cpp, listPolyHolesCmd/listPolyHolesCmd.cpp, listRichSelectionCmd/listRichSelectionCmd.cpp, lockEvent/lockEvent.cpp, manipOverride/customTriadManip.cpp, manipOverride/manipOverride.cpp, marqueeTool/marqueeTool.cpp, meshOpCmd/meshOpCmd.cpp, meshReorder/meshRemapCmd.cpp, meshReorder/meshRemapTool.h, meshReorder/meshReorderCmd.cpp, meshReorder/meshReorderTool.cpp, meshReorder/meshReorderTool.h, MetadataSample/createMetadataCmd.cpp, MetadataSample/metadataBase.cpp, motionPathCmd/motionPathCmd.cpp, motionTraceCmd/motionTraceCmd.cpp, moveCurveCVsCmd/moveCurveCVsCmd.cpp, moveManip/moveManip.cpp, moveNumericTool/moveNumericTool.cpp, moveTool/moveTool.cpp, multiPlugInfoCmd/multiPlugInfoCmd.cpp, narrowPolyViewer/narrowPolyViewer.cpp, narrowPolyViewer/narrowPolyViewer.h, nodeIconCmd/nodeIconCmd.cpp, nodeInfoCmd/nodeInfoCmd.cpp, nodeMessageCmd/nodeMessageCmd.cpp, objExport/objExport.cpp, particlePathsCmd/particlePathsCmd.cpp, particleSystemInfoCmd/particleSystemInfoCmd.cpp, peltOverlapCmd/peltOverlapCmd.cpp, pfxInfoCmd/pfxInfoCmd.cpp, pointOnMeshInfo/pointOnMeshCmd.cpp, polyMessageCmd/polyMessageCmd.cpp, polyRawExporter/polyExporter.cpp, polyX3DExporter/polyExporter.cpp, quadricShape/quadricShape.cpp, referenceQueryCmd/referenceQueryCmd.cpp, richMoveCmd/richMoveCmd.cpp, rotateManip/rotateManip.cpp, ShapeMonitor/ShapeMonitor.cpp, ShapeMonitor/ShapeMonitor.h, skinClusterWeights/skinClusterWeights.cpp, spiralAnimCurveCmd/spiralAnimCurveCmd.cpp, splitUVCmd/splitUVCmd.cpp, squareScaleManip/squareScaleManip.cpp, surfaceBumpManip/surfaceBumpManip.cpp, surfaceTwistCmd/surfaceTwistCmd.cpp, testCameraSetCmd/testCameraSetCmd.cpp, threadedBoundingBox/threadedBoundingBox.cpp, translateCmd/translateCmd.cpp, viewObjectFilter/viewObjectFilter.cpp, viewRenderOverride/viewRenderOverride.h, viewRenderOverride/viewRenderOverrideOperations.cpp, viewRenderOverrideShadows/viewRenderOverrideShadows.cpp, viewRenderOverrideShadows/viewRenderOverrideShadows.h, whatisCmd/whatisCmd.cpp, xmlAssembly/AssemblyCommand.cpp, xmlAssembly/AssemblyLoaderBase.cpp, xmlAssembly/BBoxesRep.cpp, xmlAssembly/FileRep.cpp, and xmlAssembly/FnAssetInstance.cpp.

List of all members.

Public Types

enum   MergeStrategy { kMergeNormal = 0, kXORWithList, kRemoveFromList }
  Specifies how to merge objects with those already in the list. More...

Public Member Functions

  MSelectionList ()
  Class constructor.
  MSelectionList (const MSelectionList &src)
  Copy constructor.
virtual  ~MSelectionList ()
  Class destructor.
MStatus  clear ()
  This method empties the selection list.
bool  isEmpty (MStatus *ReturnStatus=NULL) const
  Specifies whether or not the selection list contains any items.
unsigned int  length (MStatus *ReturnStatus=NULL) const
  This method returns the number of selection items in the list.
MStatus  getDependNode (unsigned int index, MObject &depNode) const
  Get a handle for the dependency node of the given element of the selection list.
MStatus  getDagPath (unsigned int index, MDagPath &dagPath, MObject &component=MObject::kNullObj) const
  Get the dag path and component (may be NULL) of the given element of the selection list.
MStatus  getPlug (unsigned int index, MPlug &plug) const
  Get the plug at the specified index of the selection list.
MStatus  add (const MObject &object, const bool mergeWithExisting=false)
  Add the specified DG node to the end of the selection list.
MStatus  add (const MDagPath &object, const MObject &component=MObject::kNullObj, const bool mergeWithExisting=false)
  Add the specified DG node to the end of the selection list.
MStatus  add (const MString &matchString, const bool searchChildNamespacesToo=false)
  Add the specified object(s) to the selection list.
MStatus  add (const MPlug &plug, const bool mergeWithExisting=false)
  Add the specified plug to the selection list.
MStatus  remove (unsigned int index)
  Removes the item at the given index from the list.
MStatus  replace (unsigned int index, const MObject &item)
  Remove the item at the given index in the list and replace it with the given object.
MStatus  replace (unsigned int index, const MDagPath &item, const MObject &component=MObject::kNullObj)
  Remove the item at the given index in the list and replace it with the given Dag item (or components).
MStatus  replace (unsigned int index, const MPlug &plug)
  Remove the item at the given index in the list and replace it with the given plug.
bool  hasItem (const MObject &item, MStatus *ReturnStatus=NULL) const
  Determines whether or not the given dependency node is in this selection list.
bool  hasItem (const MDagPath &item, const MObject &component=MObject::kNullObj, MStatus *ReturnStatus=NULL) const
  Determines whether or not the given DAG object is in this selection list.
bool  hasItem (const MPlug &plug, MStatus *ReturnStatus=NULL) const
  Determines whether or not the given plug is in this selection list.
bool  hasItemPartly (const MDagPath &item, const MObject &component, MStatus *ReturnStatus=NULL) const
  This method differs from hasItem in that it determines whether or not at least one of the components of the the given DAG object are in this selection list.
MStatus  toggle (const MDagPath &item, const MObject &component=MObject::kNullObj)
  Removes those components of the given selection item which are on the selection list, and adds those parts which are not.
MSelectionList operator= (const MSelectionList &other)
  Assignment operator.
MStatus  merge (const MSelectionList &other, const MergeStrategy strategy=kMergeNormal)
  Merge the two selection lists.
MStatus  merge (const MDagPath &object, const MObject &component=MObject::kNullObj, const MergeStrategy strategy=kMergeNormal)
  Merge the given DAG object into the selection list.
MStatus  getSelectionStrings (MStringArray &array) const
  Gets the string representations of the items in the selection list.
MStatus  getSelectionStrings (unsigned int index, MStringArray &array) const
  Gets the string representation of the given item in the selection list.

Static Public Member Functions

static const char *  className ()
  Returns the name of this class.

Member Enumeration Documentation

Specifies how to merge objects with those already in the list.

Enumerator:
kMergeNormal 

If the object is not already on the list, add it.

kXORWithList 

Exclusive OR: if the object is already on the list, remove it, otherwise add it.

kRemoveFromList 

Remove the object from the list.


Constructor & Destructor Documentation

Class constructor.

Creates an empty selection list.

MSelectionList ( const MSelectionList srcList )

Copy constructor.

This constructor will copy the contents of the given selection list into the newly create selection list.

Parameters:
[in] srcList the selection list to be copied.
~MSelectionList ( ) [virtual]

Class destructor.

Removes the selection list.


Member Function Documentation

bool isEmpty ( MStatus ReturnStatus = NULL ) const

Specifies whether or not the selection list contains any items.

Parameters:
[in] ReturnStatus Status flag
Returns:
true if the list is empty, false otherwise.
Status Codes:
Examples:
AbcExport/MayaCameraWriter.cpp, AbcImport/CreateSceneHelper.cpp, animImportExport/animImportExport.cpp, atomImportExport/atomImportExport.cpp, listRichSelectionCmd/listRichSelectionCmd.cpp, and richMoveCmd/richMoveCmd.cpp.
unsigned int length ( MStatus ReturnStatus = NULL ) const

This method returns the number of selection items in the list.

Parameters:
[out] ReturnStatus flag
Returns:
Number of items in the list
Status Codes:
Examples:
AbcExport/AbcExport.cpp, AbcExport/AbcWriteJob.cpp, AbcImport/CreateSceneHelper.cpp, animInfoCmd/animInfoCmd.cpp, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, cgfxAttrDef.cpp, cgfxShaderCmd.cpp, createClipCmd/createClipCmd.cpp, dagMessageCmd/dagMessageCmd.cpp, deletedMsgCmd/deletedMsgCmd.cpp, exportJointClusterDataCmd/exportJointClusterDataCmd.cpp, fluidInfoCmd/fluidInfoCmd.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, listPolyHolesCmd/listPolyHolesCmd.cpp, manipOverride/manipOverride.cpp, MetadataSample/createMetadataCmd.cpp, MetadataSample/metadataBase.cpp, moveNumericTool/moveNumericTool.cpp, multiPlugInfoCmd/multiPlugInfoCmd.cpp, nodeIconCmd/nodeIconCmd.cpp, nodeMessageCmd/nodeMessageCmd.cpp, objExport/objExport.cpp, particlePathsCmd/particlePathsCmd.cpp, particleSystemInfoCmd/particleSystemInfoCmd.cpp, pfxInfoCmd/pfxInfoCmd.cpp, pointOnMeshInfo/pointOnMeshCmd.cpp, polyMessageCmd/polyMessageCmd.cpp, skinClusterWeights/skinClusterWeights.cpp, threadedBoundingBox/threadedBoundingBox.cpp, viewObjectFilter/viewObjectFilter.cpp, viewRenderOverride/viewRenderOverrideOperations.cpp, viewRenderOverrideShadows/viewRenderOverrideShadows.cpp, xmlAssembly/AssemblyCommand.cpp, and xmlAssembly/AssemblyLoaderBase.cpp.
MStatus getDependNode ( unsigned int  index,
MObject depNode 
) const

Get a handle for the dependency node of the given element of the selection list.

Parameters:
[in] index the items position in the list
[out] depNode storage for the result
Returns:
Return status
Status Codes:
Examples:
AbcExport/MayaCameraWriter.cpp, AbcImport/util.cpp, animInfoCmd/animInfoCmd.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, cameraSetSubclass/testExCameraSetCmd.cpp, cgfxAttrDef.cpp, cgfxShaderCmd.cpp, closestPointOnNurbsSurfaceCmd/closestPointOnNurbsSurfaceCmd.cpp, clothPaintAttrCmd/clothPaintAttrCmd.cpp, clusterWeightFunction/clusterWeightFunction.cpp, deletedMsgCmd/deletedMsgCmd.cpp, dx11Shader/dx11ShaderCmd.cpp, fluidInfoCmd/fluidInfoCmd.cpp, hlslShader/hlslShader.cpp, hwAnisotropicShader_NV20/NodeMonitor.cpp, hwDecalBumpShader_NV20/NodeMonitor.cpp, hwReflectBumpShader_NV20/NodeMonitor.cpp, hwRefractReflectShader_NV20/NodeMonitor.cpp, hwToonShader_NV20/NodeMonitor.cpp, hwUnlitShader/NodeMonitor.cpp, intersectOnNurbsSurfaceCmd/intersectOnNurbsSurfaceCmd.cpp, latticeNoise/latticeNoiseCmd.cpp, manipOverride/manipOverride.cpp, MetadataSample/createMetadataCmd.cpp, nodeIconCmd/nodeIconCmd.cpp, nodeMessageCmd/nodeMessageCmd.cpp, objExport/objExport.cpp, particlePathsCmd/particlePathsCmd.cpp, particleSystemInfoCmd/particleSystemInfoCmd.cpp, pfxInfoCmd/pfxInfoCmd.cpp, polyMessageCmd/polyMessageCmd.cpp, ShapeMonitor/ShapeMonitor.cpp, skinClusterWeights/skinClusterWeights.cpp, testCameraSetCmd/testCameraSetCmd.cpp, xmlAssembly/AssemblyCommand.cpp, xmlAssembly/AssemblyLoaderBase.cpp, xmlAssembly/BBoxesRep.cpp, xmlAssembly/FileRep.cpp, and xmlAssembly/FnAssetInstance.cpp.
MStatus getDagPath ( unsigned int  index,
MDagPath dagPath,
MObject component = MObject::kNullObj 
) const

Get the dag path and component (may be NULL) of the given element of the selection list.

Parameters:
[in] index the items position in the list
[out] dagPath storage for the dag path of the item
[out] component storage for a handle for the component. This will be null if there is no component
Returns:
Return status
Status Codes:
Examples:
AbcExport/AbcExport.cpp, AbcExport/AbcWriteJob.cpp, AbcImport/util.cpp, apiMeshShape/apiMeshShape.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, cameraSetSubclass/testExCameraSetCmd.cpp, closestPointOnNurbsSurfaceCmd/closestPointOnNurbsSurfaceCmd.cpp, clusterWeightFunction/clusterWeightFunction.cpp, convertEdgesToFacesCmd/convertEdgesToFacesCmd.cpp, convertVerticesToEdgesCmd/convertVerticesToEdgesCmd.cpp, convertVerticesToFacesCmd/convertVerticesToFacesCmd.cpp, cvColorShader/cvColorShader.cpp, dagMessageCmd/dagMessageCmd.cpp, dx11Shader/dx11ShaderCmd.cpp, exportJointClusterDataCmd/exportJointClusterDataCmd.cpp, findTexturesPerPolygonCmd/findTexturesPerPolygonCmd.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, intersectOnNurbsSurfaceCmd/intersectOnNurbsSurfaceCmd.cpp, listLightLinksCmd/listLightLinksCmd.cpp, listPolyHolesCmd/listPolyHolesCmd.cpp, MetadataSample/metadataBase.cpp, moveNumericTool/moveNumericTool.cpp, narrowPolyViewer/narrowPolyViewer.cpp, objExport/objExport.cpp, peltOverlapCmd/peltOverlapCmd.cpp, pointOnMeshInfo/pointOnMeshCmd.cpp, ShapeMonitor/ShapeMonitor.cpp, skinClusterWeights/skinClusterWeights.cpp, testCameraSetCmd/testCameraSetCmd.cpp, threadedBoundingBox/threadedBoundingBox.cpp, and viewRenderOverrideShadows/viewRenderOverrideShadows.cpp.
MStatus getPlug ( unsigned int  index,
MPlug plug 
) const

Get the plug at the specified index of the selection list.

Parameters:
[in] index the items position in the list
[out] plug storage for the result
Returns:
Return status
Status Codes:
Examples:
animInfoCmd/animInfoCmd.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, and multiPlugInfoCmd/multiPlugInfoCmd.cpp.
MStatus add ( const MObject object,
const bool  mergeWithExisting = false 
)

Add the specified DG node to the end of the selection list.

If mergeWithExisting is true, the given item is unconditionally added to the end of the list. Otherwise, If the item is already on the list, it is moved from its current position to the end of the list.

Parameters:
[in] object The object to add
[in] mergeWithExisting merge new item with existing one, or add unconditionally to end of list.
Returns:
Status flag
Status Codes:
Examples:
AbcExport/AbcExport.cpp, AbcExport/MayaCameraWriter.cpp, AbcImport/CreateSceneHelper.cpp, AbcImport/util.cpp, animInfoCmd/animInfoCmd.cpp, apiMeshShape/apiMeshShape.cpp, apiMeshShape/apiMeshShapeUI.cpp, apiSimpleShape/apiSimpleShapeUI.cpp, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, cameraSetSubclass/testExCameraSetCmd.cpp, cgfxShaderCmd.cpp, closestPointCmd/closestPointCmd.cpp, clothPaintAttrCmd/clothPaintAttrCmd.cpp, convertEdgesToFacesCmd/convertEdgesToFacesCmd.cpp, convertVerticesToEdgesCmd/convertVerticesToEdgesCmd.cpp, convertVerticesToFacesCmd/convertVerticesToFacesCmd.cpp, createClipCmd/createClipCmd.cpp, cvExpandCmd/cvExpandCmd.cpp, cvPosCmd/cvPosCmd.cpp, dx11Shader/dx11ShaderCmd.cpp, findFileTexturesCmd/findFileTexturesCmd.cpp, fluidInfoCmd/fluidInfoCmd.cpp, getAttrAffectsCmd/getAttrAffectsCmd.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheShapeNode.cpp, hlslShader/hlslShader.cpp, hwAnisotropicShader_NV20/NodeMonitor.cpp, hwDecalBumpShader_NV20/NodeMonitor.cpp, hwReflectBumpShader_NV20/NodeMonitor.cpp, hwRefractReflectShader_NV20/NodeMonitor.cpp, hwToonShader_NV20/NodeMonitor.cpp, hwUnlitShader/NodeMonitor.cpp, intersectCmd/intersectCmd.cpp, lassoTool/lassoTool.cpp, latticeNoise/latticeNoiseCmd.cpp, listLightLinksCmd/listLightLinksCmd.cpp, meshReorder/meshRemapCmd.cpp, meshReorder/meshReorderCmd.cpp, narrowPolyViewer/narrowPolyViewer.cpp, objExport/objExport.cpp, particleSystemInfoCmd/particleSystemInfoCmd.cpp, peltOverlapCmd/peltOverlapCmd.cpp, pfxInfoCmd/pfxInfoCmd.cpp, pointOnMeshInfo/pointOnMeshCmd.cpp, quadricShape/quadricShape.cpp, ShapeMonitor/ShapeMonitor.cpp, skinClusterWeights/skinClusterWeights.cpp, testCameraSetCmd/testCameraSetCmd.cpp, viewObjectFilter/viewObjectFilter.cpp, whatisCmd/whatisCmd.cpp, xmlAssembly/AssemblyLoaderBase.cpp, xmlAssembly/BBoxesRep.cpp, xmlAssembly/FileRep.cpp, and xmlAssembly/FnAssetInstance.cpp.
MStatus add ( const MDagPath object,
const MObject component = MObject::kNullObj,
const bool  mergeWithExisting = false 
)

Add the specified DG node to the end of the selection list.

If mergeWithExisting is true, the given item is unconditionally added to the end of the list. Otherwise, If the item is already on the list, it is moved from its current position to the end of the list. If the item was already on the list, and had components specified, the components from the given item are merged into those of the existing item.

Parameters:
[in] object The Dag Object to add
[in] component components of the object
[in] mergeWithExisting merge new item with existing one, or add unconditionally to end of list.
Returns:
Status flag
Status Codes:
  • MS::kSuccess Object successfully added to the list
  • MS::kInvalidParameter item is null or contains an invalid DagPath, or the component parameter is not a handle to a valid component
  • MS::kFailure Error adding the object to the list
MStatus add ( const MString matchString,
const bool  searchChildNamespacesToo = false 
)

Add the specified object(s) to the selection list.

There is an option to search all child namespaces. The object name should be specified in the same way it would be in the MEL language. It is possible to use wildcard characters, so multiple objects may be added in one method call.

NOTE: the actual namespace being searched is important. In relativeNames mode (see the method MNamespace::relativeNames), the search starts in the current namespace but with relativeNames mode off, the search starts with the root namespace.

Parameters:
[in] matchString object match string
[in] searchChildNamespacesToo optional parameter to specify that child namespaces will also be searched. A value of true enables child namespace searching; a value of false (the default) only searches within the namespace. See the above description for details on which namespace gets searched.
Returns:
Return status
Status Codes:
MStatus add ( const MPlug plug,
const bool  mergeWithExisting = false 
)

Add the specified plug to the selection list.

Parameters:
[in] plug the plug to add
[in] mergeWithExisting merge new item with existing one, or add unconditionally to end of list.
Returns:
Return status
Status Codes:
MStatus remove ( unsigned int  index )

Removes the item at the given index from the list.

Parameters:
[in] index The index of the item to be removed
Returns:
Status flag
Status Codes:
Examples:
atomImportExport/atomFileUtils.cpp.
MStatus replace ( unsigned int  index,
const MObject item 
)

Remove the item at the given index in the list and replace it with the given object.

The given index must not be greater than the current number of items on the list.

Parameters:
[in] item A pointer to the replacement object
[in] index The index of the item to remove from the list
Returns:
Status flag
Status Codes:
MStatus replace ( unsigned int  index,
const MDagPath item,
const MObject component = MObject::kNullObj 
)

Remove the item at the given index in the list and replace it with the given Dag item (or components).

The given index must not be greater than the current number of items on the list.

Parameters:
[in] item the new dag object to place into the list
[in] component the components of item to add
[in] index The index of the item to remove from the list
Returns:
Status flag
Status Codes:
MStatus replace ( unsigned int  index,
const MPlug plug 
)

Remove the item at the given index in the list and replace it with the given plug.

The given index must not be greater than the current number of items on the list.

Parameters:
[in] plug The replacement plug
[in] index The index of the item to remove from the list
Returns:
Status flag
Status Codes:
bool hasItem ( const MObject item,
MStatus ReturnStatus = NULL 
) const

Determines whether or not the given dependency node is in this selection list.

Note that if the selection list contains a DAG node, the overloaded version of this method that takes an MDagPath must be used. A dag path will not compare identically to a DG node, even if they both refer to the same node.

Parameters:
[in] item The item to check for
[out] ReturnStatus Status flag
Returns:
true if the item is in this list, false otherwise
Status Codes:
Examples:
apiMeshShape/apiMeshSubSceneOverride.cpp, and viewRenderOverrideShadows/viewRenderOverrideShadows.cpp.
bool hasItem ( const MDagPath item,
const MObject component = MObject::kNullObj,
MStatus ReturnStatus = NULL 
) const

Determines whether or not the given DAG object is in this selection list.

If the component argument is non-null, then this method will only return true of all the components of the given DAG object are on the selection list.

Parameters:
[in] item the DAG object to check for
[in] component the components of item to check for
[out] ReturnStatus Status flag
Returns:
true if the item or component is in this list, false otherwise
Status Codes:
bool hasItem ( const MPlug plug,
MStatus ReturnStatus = NULL 
) const

Determines whether or not the given plug is in this selection list.

Parameters:
[in] plug The plug to check for
[out] ReturnStatus Status flag
Returns:
true if the plug is in this list, false otherwise
Status Codes:
bool hasItemPartly ( const MDagPath item,
const MObject component,
MStatus ReturnStatus = NULL 
) const

This method differs from hasItem in that it determines whether or not at least one of the components of the the given DAG object are in this selection list.

This method is only applicable when multiple components are provided.

Parameters:
[in] item the DAG object to check for
[in] component the components of item to check for
[out] ReturnStatus Status flag
Returns:
true if at least one of the components in this list, false otherwise
Status Codes:
Examples:
ShapeMonitor/ShapeMonitor.cpp.
MStatus toggle ( const MDagPath item,
const MObject component = MObject::kNullObj 
)

Removes those components of the given selection item which are on the selection list, and adds those parts which are not.

This method does nothing if no components are provided.

Parameters:
[in] item Dag object to be toggled
[in] component components of the object
Returns:
Status flag
Status Codes:
MSelectionList & operator= ( const MSelectionList other )

Assignment operator.

Parameters:
[in] other the selection list to be copied
Returns:
A reference to the copied selection list
MStatus merge ( const MSelectionList other,
const MergeStrategy  strategy = kMergeNormal 
)

Merge the two selection lists.

Parameters:
[in] other the selection list to be merged.
[in] strategy the merging strategy. It can be one of the the following:
Returns:
Status flag
Status Codes:
Examples:
AbcImport/CreateSceneHelper.cpp, atomImportExport/atomAnimLayers.cpp, and listLightLinksCmd/listLightLinksCmd.cpp.
MStatus merge ( const MDagPath item,
const MObject component = MObject::kNullObj,
const MergeStrategy  strategy = kMergeNormal 
)

Merge the given DAG object into the selection list.

Parameters:
[in] item the dependency node to be merged.
[in] component components of the Dag object to add
[in] strategy the merging strategy. It can be one of the following:
Returns:
Status flag
Status Codes:
  • kSuccess Method successfull
  • MS::kInvalidParameter item is null or contains an invalid DagPath, or the component parameter is not a handle to a valid component
  • kFailure Operation failed
MStatus getSelectionStrings ( MStringArray array ) const

Gets the string representations of the items in the selection list.

The strings will be in the format used by the scripting language.

Parameters:
[out] array storage for the returned strings
Returns:
Status flag
Status Codes:
Examples:
cgfxShaderCmd.cpp, convertEdgesToFacesCmd/convertEdgesToFacesCmd.cpp, convertVerticesToEdgesCmd/convertVerticesToEdgesCmd.cpp, convertVerticesToFacesCmd/convertVerticesToFacesCmd.cpp, and cvExpandCmd/cvExpandCmd.cpp.
MStatus getSelectionStrings ( unsigned int  index,
MStringArray array 
) const

Gets the string representation of the given item in the selection list.

The strings will be in the format used by the scripting language. More than one string will be returned in the case that the item in the selection list has a component that that contains elements that are not contiguous (eg CV's 2 and 8 are selected on a surface).

Parameters:
[in] index index of the element to get
[out] array storage for the returned strings
Returns:
Status flag
Status Codes:
const char * className ( ) [static]

Returns the name of this class.

Returns:
The name of this class.

The documentation for this class was generated from the following files: