MFnMessageAttribute Class Reference
[OpenMaya - API module for common classesFunctionSet classes]

#include <MFnMessageAttribute.h>

Inheritance diagram for MFnMessageAttribute:

Inheritance graph
[legend]
Collaboration diagram for MFnMessageAttribute:

Collaboration graph
[legend]

List of all members.


Detailed Description

Message attribute function set.

Function set for message attributes. A message attribute is a dependency node attribute that does not transmit data. Message attributes only exist to formally declare relationships between nodes. By connecting two nodes via message attributes, a relationship between those nodes is expressed. Message attribute connections can be traversed in the same manner as any other connection in the dependency graph.

Public Member Functions

virtual MFn::Type type () const
 Function set type.
virtual ~MFnMessageAttribute ()
 Destructor.
 MFnMessageAttribute ()
 Default constructor.
 MFnMessageAttribute (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.
MObject create (const MString &fullName, const MString &briefName, MStatus *ReturnStatus=NULL)
 MFnMessageAttribute (const MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.

Protected Member Functions

virtual const char * className () const
 Class name.


Constructor & Destructor Documentation

MFnMessageAttribute::MFnMessageAttribute ( 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:

MFnMessageAttribute::MFnMessageAttribute ( 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 MFnMessageAttribute::type (  )  const [virtual]

Function set type.

Return the class type : MFn::kMessageAttribute

Reimplemented from MFnAttribute.

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

Class name.

Return the class name : "MFnMessageAttribute"

Reimplemented from MFnAttribute.

MObject MFnMessageAttribute::create ( const MString fullName,
const MString briefName,
MStatus ReturnStatus = NULL 
)

Creates a Message attribute object.

The create method needs to be called on a per node basis. That means if you want to create and add the same attribute to multiple nodes, you need to call the create method for each node to get a unique MObject back. If you call create just once and add the attribute to multiple nodes, Maya will encounter a fatal error.

Parameters:
[in] fullName The full name of the attribute
[in] briefName The brief name of the attribute
[out] ReturnStatus Status code for the operation.
Returns:
The newly created Message attribute object.
Status Codes:


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