MFnStateManip Class Reference
[OpenMayaUI - API module for user interfaceFunctionSet classes]

#include <MFnStateManip.h>

Inheritance diagram for MFnStateManip:

Inheritance graph
[legend]
Collaboration diagram for MFnStateManip:

Collaboration graph
[legend]

List of all members.


Detailed Description

StateManip function set.

The StateManip allows the user to switch between multiple states. It is drawn as a circle with a notch. Each click on the circle increments the value of the state (modulo the maximum number of states). This manipulator generates an integer value corresponding to the state of the manip.

Examples:

rotateManip.cpp, and swissArmyManip.cpp.


Public Member Functions

virtual MFn::Type type () const
 Function set type.
virtual ~MFnStateManip ()
 Destructor.
 MFnStateManip ()
 Default constructor.
 MFnStateManip (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.
 MFnStateManip (const MDagPath &object, MStatus *ret=NULL)
 Constructor.
MObject create (MStatus *ReturnStatus=NULL)
MObject create (const MString &manipName, const MString &stateName, MStatus *ReturnStatus=NULL)
MStatus connectToStatePlug (MPlug &statePlug)
MStatus setInitialState (unsigned int initialState)
MStatus setMaxStates (unsigned int numStates)
unsigned int maxStates (MStatus *ReturnStatus=NULL) const
unsigned int state (MStatus *ReturnStatus=NULL) const
unsigned int positionIndex (MStatus *ReturnStatus=NULL) const
unsigned int stateIndex (MStatus *ReturnStatus=NULL) const
 MFnStateManip (const MObject &object, MStatus *ret=NULL)
 Constructor.

Protected Member Functions

virtual const char * className () const
 Class name.

Constructor & Destructor Documentation

MFnStateManip::~MFnStateManip (  )  [virtual]

Destructor.

Class destructor.

MFnStateManip::MFnStateManip ( MObject object,
MStatus ReturnStatus = NULL 
)

Constructor.

Class constructor that initializes the function set to the given MObject.

Parameters:
[in] object The MObject to attach the function set to
[out] ReturnStatus the return status
Status Codes:

MFnStateManip::MFnStateManip ( const MDagPath object,
MStatus ReturnStatus = NULL 
)

Constructor.

Class constructor that initializes the function set to the given constant MDagPath object.

Parameters:
[in] object The const MDagPath to attach the function set to
[out] ReturnStatus The return status
Status Codes:

MFnStateManip::MFnStateManip ( const MObject object,
MStatus ReturnStatus = NULL 
)

Constructor.

Class constructor that initializes the function set to the given MObject.

Parameters:
[in] object The MObject to attach the function set to
[out] ReturnStatus the return status
Status Codes:


Member Function Documentation

MFn::Type MFnStateManip::type (  )  const [virtual]

Function set type.

Return the class type : MFn::kStateManip

Reimplemented from MFnManip3D.

const char * MFnStateManip::className (  )  const [protected, virtual]

Class name.

Return the class name : "MFnStateManip"

Reimplemented from MFnManip3D.

MObject MFnStateManip::create ( MStatus ReturnStatus = NULL  ) 

Creates a new StateManip. This function set's object is set to be the new manipulator.

This method should only be used to create a non-composite StateManip.

The name that appears in the feedback line is "state"

Parameters:
[out] ReturnStatus return status
Returns:
Newly created StateManip
Status Codes:

MObject MFnStateManip::create ( const MString manipName,
const MString stateName,
MStatus ReturnStatus = NULL 
)

Creates a new StateManip. This function set's object is set to be the new manipulator.

This method should only be used to create a non-composite StateManip.

The name that appears in the feedback line is specified by the stateName argument.

Parameters:
[in] stateName the name that appears in the feedback line
[out] ReturnStatus return status
Returns:
Newly created StateManip
Status Codes:

Reimplemented from MFnDependencyNode.

MStatus MFnStateManip::connectToStatePlug ( MPlug statePlug  ) 

Connect to the state plug. The data type corresponding to the statePlug is a int integer.

Parameters:
[in] statePlug the state plug
Returns:

MStatus MFnStateManip::setInitialState ( unsigned int  initialState  ) 

Sets the initial state of the StateManip.

Parameters:
[in] initialState initial state of the StateManip
Returns:

MStatus MFnStateManip::setMaxStates ( unsigned int  numStates  ) 

Sets the maximum number of states that the StateManip will have. The default number of maximum states is 4.

Parameters:
[in] numStates the maxiumum number of states
Returns:

unsigned int MFnStateManip::maxStates ( MStatus ReturnStatus = NULL  )  const

Returns the number of maximum states.

Parameters:
[out] ReturnStatus return status
Returns:
Maximum states
Status Codes:

unsigned int MFnStateManip::state ( MStatus ReturnStatus = NULL  )  const

Returns the current state.

Parameters:
[out] ReturnStatus return status
Returns:
Current states
Status Codes:

unsigned int MFnStateManip::positionIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the position of the StateManip. The data type corresponding to this index is MFnNumericData::k3Double.

Parameters:
[out] ReturnStatus return status
Returns:
Position index
Status Codes:

unsigned int MFnStateManip::stateIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the state. The data type corresponding to this index is a int integer.

Parameters:
[out] ReturnStatus return status
Returns:
State index
Status Codes:


Autodesk® Maya® 2009 © 1997-2008 Autodesk, Inc. All rights reserved. Generated with doxygen 1.5.6