#include <MMessage.h>

Class Description

Message base class.

This is the base class for message callbacks. This base class allows the user to remove a message callback. To register a callback, the user must use the addCallback methods in the message classes which inherit from this base class.

When a callback is added a number or id is returned. This id is used to keep track of the callback and is necessary for removing it. A callback id with the value 'NULL' represents an invalid callback. Use the removeCallback member function of this class for removing a callback.

It is the user's responsibility to keep track of the callback id's and remove all callbacks for a plug-in when it is unloaded.

Callbacks During File Read

Care must be taken when a callback executes while Maya is reading a scene file as the scene may be temporarily in an inconsistent state, which could give incorrect results.

For example, consider a scene which has two nodes, X and Y, with a connection from X.out to Y.in. A "node added" message (see MDGMessage::addNodeAddedCallback) will be sent out for Y as soon as it is added to the scene, but before the connection has been made to Y.in. If a callback were to read the value of Y.in at this point it would get the wrong result.

The difficulties are compounded by the fact that Maya's normal Dependency Graph evaluation and dirty propagation mechanisms are disabled during a file read. In our example above, retrieving the value of Y.in will mark the plug as clean. When the connection is from X.out is subsequently made, Y.in won't be marked dirty because dirty propagation is disabled. As a result, when the file read has completed and Maya draws the new scene, Y.in will not be re-evaluated which may produce an error in the draw.

For these reasons, callbacks should avoid querying or modifying the DG in any way during file read. They should not add or remove nodes, make or break connections, change parenting, set or retrieve plug values, etc. Even something as innocuous as a call to MFnDagNode::isIntermediateObject may cause problems since it queries the value of the node's intermediateObject plug. All such actions should be postponed until the file read has completed.

Inheritance diagram for MMessage:

Public Types
enum	Action { kDefaultAction, kDoNotDoAction, kDoAction }
	Callback result action codes. More...

typedef void(*	MBasicFunction) (void *clientData)
	Pointer to a basic callback function. More...

typedef void(*	MElapsedTimeFunction) (float elapsedTime, float lastTime, void *clientData)
	Pointer to an elapsed time callback function. More...

typedef void(*	MCheckFunction) (bool retCode, void clientData)
	Pointer to callback function which returns a true/false result. More...

typedef void(*	MCheckFileFunction) (bool retCode, MFileObject &file, void clientData)
	Pointer to a callback function which takes a file object and returns a result. More...

typedef void(*	MCheckPlugFunction) (bool retCode, MPlug &plug, void clientData)
	Pointer to a callback function which takes a plug and returns a result. More...

typedef void(*	MComponentFunction) (MUintArray componentIds[], unsigned int count, void *clientData)
	Pointer to a callback function which takes an array of component ids. More...

typedef void(*	MNodeFunction) (MObject &node, void *clientData)
	Pointer to a callback function which takes a dependency node. More...

typedef void(*	MStringFunction) (const MString &str, void *clientData)
	Pointer to callback function which takes a string. More...

typedef void(*	MTwoStringFunction) (const MString &str1, const MString &str2, void *clientData)
	Pointer to a callback function which takes two strings. More...

typedef void(*	MThreeStringFunction) (const MString &str1, const MString &str2, const MString &str3, void *clientData)
	Pointer to a callback function which takes three strings. More...

typedef void(*	MStringIntBoolIntFunction) (const MString &str, unsigned int index, bool flag, unsigned int type, void *clientData)
	Pointer to callback function which takes a string, an index, a flag and a type. More...

typedef void(*	MStringIndexFunction) (const MString &, unsigned int index, void *clientData)
	Pointer to callback function which takes a string and index. More...

typedef void(*	MNodeStringBoolFunction) (MObject &node, const MString &, bool, void *clientData)
	Pointer to a callback function which takes a node, a string and a boolean. More...

typedef void(*	MStateFunction) (bool state, void *clientData)
	Pointer to a callback function which takes a boolean state. More...

typedef void(*	MTimeFunction) (MTime &time, void *clientData)
	Pointer to callback function which takes a time. More...

typedef void(*	MPlugFunction) (MPlug &srcPlug, MPlug &destPlug, bool made, void *clientData)
	Pointer to plug connection callback function. More...

typedef void(*	MNodePlugFunction) (MObject &node, MPlug &plug, void *clientData)
	Pointer to a callback function which takes a dependency node and a plug. More...

typedef void(*	MNodeStringFunction) (MObject &node, const MString &str, void *clientData)
	Pointer to a callback function which takes a dependency node and a string. More...

typedef void(*	MParentChildFunction) (MDagPath &child, MDagPath &parent, void *clientData)
	Pointer to to a callback function which takes two DAG nodes in a parent/child relationship. More...

typedef void(*	MModifierFunction) (MDGModifier &modifier, void *clientData)
	Pointer to a callback function which takes a DG modifier. More...

typedef void(*	MStringArrayFunction) (const MStringArray &strs, void *clientData)
	Pointer to a callback function which takes a string array. More...

typedef void(*	MNodeModifierFunction) (MObject &node, MDGModifier &modifier, void *clientData)
	Pointer to a callback function which takes a dependency node and a DG modifier. More...

typedef void(*	MObjArray) (MObjectArray &objects, void *clientData)
	Pointer to a callback function which takes an array of objects. More...

typedef void(*	MNodeObjArray) (MObject &node, MObjectArray &objects, void *clientData)
	Pointer to a callback function which takes a dependency node and an array of objects. More...

typedef void(*	MStringNode) (const MString &str, MObject &node, void *clientData)
	Pointer to a callback function which takes a string and a dependency node. More...

typedef void(*	MCameraLayerFunction) (MObject &cameraSetNode, unsigned int multiIndex, bool added, void *clientData)
	Pointer to a callback function which takes a dependency node, an unsigned integer, and a boolean value. More...

typedef void(*	MCameraLayerCameraFunction) (MObject &cameraSetNode, unsigned int multiIndex, MObject &oldCamera, MObject &newCamera, void *clientData)
	Pointer to a callback function which takes a dependency node, an unsigned integer, and two camera transform nodes. More...

typedef void(*	MConnFailFunction) (MPlug &srcPlug, MPlug &destPlug, const MString &srcPlugName, const MString &dstPlugName, void *clientData)
	Pointer to connection-failed callback function. More...

typedef void(*	MPlugsDGModFunction) (MPlugArray &plugs, MDGModifier &modifier, void *clientData)
	Pointer to a callback function which takes an array of MPlugs and an MDGModifier. More...

typedef void(*	MNodeUuidFunction) (MObject &node, const MUuid &uuid, void *clientData)
	Pointer to a callback function which takes a dependency node and a UUID. More...

typedef Action(*	MCheckNodeUuidFunction) (bool doAction, MObject &node, MUuid &uuid, void *clientData)
	Pointer to a callback function which takes a dependency node and a UUID, and returns a result. More...

typedef void(*	MObjectFileFunction) (const MObject &object, const MFileObject &file, void *clientData)
	Pointer to a callback function which takes an object and a file object. More...

typedef void(*	MCheckObjectFileFunction) (bool retCode, const MObject &referenceNode, MFileObject &file, void clientData)
	Pointer to a callback function which takes an object and a file object and returns a result. More...

typedef void(*	MRenderTileFunction) (int originX, int originY, int tileMaxX, int tileMaxY, const void *tileData)
	Pointer to a callback function which receives origin, size and image data. More...

Static Public Member Functions
static MStatus	removeCallback (MCallbackId id)
	Remove the specified callback from maya. More...

static MStatus	removeCallbacks (MCallbackIdArray &ids)
	Remove all of the specified callbacks from maya. More...

static MCallbackId	currentCallbackId (MStatus *ReturnStatus=NULL)
	Return the callback ID of the currently executing callback. More...

static MStatus	nodeCallbacks (MObject &node, MCallbackIdArray &ids)
	Returns a list of callback IDs associated registered to a given node. More...

static void	setRegisteringCallableScript ()
	Mark this MMessage object as one that will be passed callbacks defined in script.

static bool	registeringCallableScript ()
	Return true if this MMessage object has its callbacks defined in script.

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

static MStatus	removeCallbacks (MIntArray &ids)
	This method is obsolete. This method is not available in Python. More...

static MStatus	nodeCallbacks (MObject &node, MIntArray &ids)
	This method is obsolete. More...

Friends
class	MRenderCallback

Member Typedef Documentation

typedef void(* MBasicFunction) (void *clientData)

Pointer to a basic callback function.

Parameters

[in] clientData Pointer to user-defined data supplied when the callback was registered.

typedef void(* MElapsedTimeFunction) (float elapsedTime, float lastTime, void *clientData)

Pointer to an elapsed time callback function.

Parameters

[in]	elapsedTime	The amount of time since the callback was last called.
[in]	lastTime	The execution time at the previous call to this callback.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MCheckFunction) (bool *retCode, void *clientData)

Pointer to callback function which returns a true/false result.

Parameters

[in]	retCode	Result of the function. The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MCheckFileFunction) (bool *retCode, MFileObject &file, void *clientData)

Pointer to a callback function which takes a file object and returns a result.

Parameters

[in]	retCode	Result of the function. The meaning depends upon the specific message type for which the callback was registered.
[in,out]	file	File object. The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MCheckPlugFunction) (bool *retCode, MPlug &plug, void *clientData)

Pointer to a callback function which takes a plug and returns a result.

Parameters

[in]	retCode	Result of the function. The meaning depends upon the specific message type for which the callback was registered.
[in,out]	plug	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MComponentFunction) (MUintArray componentIds[], unsigned int count, void *clientData)

Pointer to a callback function which takes an array of component ids.

Parameters

[in]	componentIds	Array of component ids.
[in]	count	Number of component ids in the array.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodeFunction) (MObject &node, void *clientData)

Pointer to a callback function which takes a dependency node.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MStringFunction) (const MString &str, void *clientData)

Pointer to callback function which takes a string.

Parameters

[in]	str	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MTwoStringFunction) (const MString &str1, const MString &str2, void *clientData)

Pointer to a callback function which takes two strings.

Parameters

[in]	str1	Meaning depends upon the message for which the callback was registered.
[in]	str2	Meaning depends upon the message for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MThreeStringFunction) (const MString &str1, const MString &str2, const MString &str3, void *clientData)

Pointer to a callback function which takes three strings.

Parameters

[in]	str1	Meaning depends upon the message for which the callback was registered.
[in]	str2	Meaning depends upon the message for which the callback was registered.
[in]	str3	Meaning depends upon the message for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MStringIntBoolIntFunction) (const MString &str, unsigned int index, bool flag, unsigned int type, void *clientData)

Pointer to callback function which takes a string, an index, a flag and a type.

Parameters

[in]	str	The meaning depends upon the specific message type for which the callback was registered.
[in]	index	The meaning depends upon the specific message type for which the callback was registered.
[in]	flag	The meaning depends upon the specific message type for which the callback was registered.
[in]	type	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MStringIndexFunction) (const MString &, unsigned int index, void *clientData)

Pointer to callback function which takes a string and index.

Parameters

[in]	str	The meaning depends upon the specific message type for which the callback was registered.
[in]	index	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodeStringBoolFunction) (MObject &node, const MString &, bool, void *clientData)

Pointer to a callback function which takes a node, a string and a boolean.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in]	str	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MStateFunction) (bool state, void *clientData)

Pointer to a callback function which takes a boolean state.

Parameters

[in]	state	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MTimeFunction) (MTime &time, void *clientData)

Pointer to callback function which takes a time.

Parameters

[in,out]	time	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MPlugFunction) (MPlug &srcPlug, MPlug &destPlug, bool made, void *clientData)

Pointer to plug connection callback function.

Parameters

[in,out]	srcPlug	Plug which is the source of the connection.
[in,out]	destPlug	Plug which is the destination of the connection.
[in]	made	True if the connection is being made, false if the connection is being broken.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodePlugFunction) (MObject &node, MPlug &plug, void *clientData)

Pointer to a callback function which takes a dependency node and a plug.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	plug	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodeStringFunction) (MObject &node, const MString &str, void *clientData)

Pointer to a callback function which takes a dependency node and a string.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in]	str	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MParentChildFunction) (MDagPath &child, MDagPath &parent, void *clientData)

Pointer to to a callback function which takes two DAG nodes in a parent/child relationship.

Parameters

[in,out]	child	Path to the child node.
[in,out]	parent	Path to the parent node.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MModifierFunction) (MDGModifier &modifier, void *clientData)

Pointer to a callback function which takes a DG modifier.

Parameters

[in,out]	modifier	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MStringArrayFunction) (const MStringArray &strs, void *clientData)

Pointer to a callback function which takes a string array.

Parameters

[in]	strs	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodeModifierFunction) (MObject &node, MDGModifier &modifier, void *clientData)

Pointer to a callback function which takes a dependency node and a DG modifier.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	modifier	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MObjArray) (MObjectArray &objects, void *clientData)

Pointer to a callback function which takes an array of objects.

Parameters

[in,out]	objects	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodeObjArray) (MObject &node, MObjectArray &objects, void *clientData)

Pointer to a callback function which takes a dependency node and an array of objects.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	objects	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MStringNode) (const MString &str, MObject &node, void *clientData)

Pointer to a callback function which takes a string and a dependency node.

Parameters

[in]	str	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MCameraLayerFunction) (MObject &cameraSetNode, unsigned int multiIndex, bool added, void *clientData)

Pointer to a callback function which takes a dependency node, an unsigned integer, and a boolean value.

Parameters

[in]	node	The node should be a cameraSet node.
[in]	unsigned	int The integer refers to a camera layer index in the given cameraSet node.
[in]	bool	The value denotes whether the given camera layer has been added or removed. A value of true means the layer was added.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MCameraLayerCameraFunction) (MObject &cameraSetNode, unsigned int multiIndex, MObject &oldCamera, MObject &newCamera, void *clientData)

Pointer to a callback function which takes a dependency node, an unsigned integer, and two camera transform nodes.

Parameters

[in]	node	The node should be a cameraSet node.
[in]	unsigned	int The integer refers to a camera layer index in the given cameraSet node.
[in]	node	The node should be a camera transform previously assigned to the given camera layer.
[in]	node	The node should be a camera transform newly assigned to the given camera layer.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MConnFailFunction) (MPlug &srcPlug, MPlug &destPlug, const MString &srcPlugName, const MString &dstPlugName, void *clientData)

Pointer to connection-failed callback function.

Parameters

[in,out]	srcPlug	Plug which was to be the source of the connection, or a null plug if the plug did not exist.
[in,out]	destPlug	Plug which was to be the destination of the connection, or a null plug if the plug did not exist.
[in]	srcPlugName	The plug name which was used to look up the source plug.
[in]	dstPlugName	The plug name which was used to look up the destination plug.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MPlugsDGModFunction) (MPlugArray &plugs, MDGModifier &modifier, void *clientData)

Pointer to a callback function which takes an array of MPlugs and an MDGModifier.

Parameters

[in,out]	plugs	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	modifier	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MNodeUuidFunction) (MObject &node, const MUuid &uuid, void *clientData)

Pointer to a callback function which takes a dependency node and a UUID.

Parameters

[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	uuid	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef Action(* MCheckNodeUuidFunction) (bool doAction, MObject &node, MUuid &uuid, void *clientData)

Pointer to a callback function which takes a dependency node and a UUID, and returns a result.

Parameters

[in]	doAction	The default action to be taken by the function, if kDefaultAction is returned. The meaning depends upon the specific message type for which the callback was registered.
[in,out]	node	The meaning depends upon the specific message type for which the callback was registered.
[in,out]	uuid	The meaning depends upon the specific message type for which the callback was registered.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

Returns: Action to be taken as a result of the function. The meaning depends upon the specific message type for which the callback was registered.

typedef void(* MObjectFileFunction) (const MObject &object, const MFileObject &file, void *clientData)

Pointer to a callback function which takes an object and a file object.

Parameters

[in]	referenceNode	The object (typically a DG node) to which the callback relates.
[in]	file	The resolved file path of the referenced file.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MCheckObjectFileFunction) (bool *retCode, const MObject &referenceNode, MFileObject &file, void *clientData)

Pointer to a callback function which takes an object and a file object and returns a result.

Parameters

[in]	retCode	Result of the function. The meaning depends upon the specific message type for which the callback was registered.
[in]	referenceNode	The object (typically a DG node) to which the callback relates.
[in]	file	The resolved file path of the referenced file.
[in]	clientData	Pointer to user-defined data supplied when the callback was registered.

typedef void(* MRenderTileFunction) (int originX, int originY, int tileMaxX, int tileMaxY, const void *tileData)

Pointer to a callback function which receives origin, size and image data.

Parameters

[out]	originX	X coordinate of the tile's origin point relative to the final image.
[out]	originY	Y coordinate of the tile's origin point relative to the final image.
[out]	tileMaxX	X coordinate of the tile's end point relative to the final image.
[out]	tileMaxY	Y coordinate of the tile's end point relative to the final image.
[out]	tileData	the pixel data for the tile.

Member Enumeration Documentation

enum Action

Callback result action codes.

Enumerator
kDefaultAction	do the action or not, whatever is the default
kDoNotDoAction	do not do the action
kDoAction	do the action

Member Function Documentation

MStatus removeCallback ( MCallbackId id )

static

Remove the specified callback from maya.

This method must be called for all callbacks registered by a plug-in before that plug-in is unloaded.

Parameters

[in] id identifier of callback to be removed

Returns: Status code

Status Codes:

MS::kSuccess The callback was successfully removed.
MS::kInvalidParameter An invalid callback id was specfied.
MS::kFailure Callback has already been removed.

Examples:: apiDirectionalLightShape/apiDirectionalLightShape.cpp, apiMeshShape/apiMeshShape.cpp, atomImportExport/atomImportExport.cpp, autoLoader/autoLoader.cpp, cgFx/cgfxAttrDef.cpp, componentScaleManip/componentScaleManip.cpp, conditionTest/conditionTest.cpp, customAttrManip/customAttrManip.cpp, D3DViewportRenderer/D3DResourceManager.cpp, D3DViewportRenderer/D3DViewportRendererPlugin.cpp, dagMessageCmd/dagMessageCmd.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, DX11ViewportRenderer/DX11ResourceManager.cpp, DX11ViewportRenderer/DX11ViewportRendererPlugin.cpp, eventTest/eventTest.cpp, footPrintManip/footPrintManip.cpp, footPrintNode/footPrintNode.cpp, footPrintNode_SubSceneOverride/footPrintNode_SubSceneOverride.cpp, glslShader/GLSLShader.cpp, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, gpuCache/gpuCacheVBOProxy.cpp, hlslShader/hlslShader.cpp, hwAnisotropicShader_NV20/hwAnisotropicShader_NV20.cpp, hwAnisotropicShader_NV20/NodeMonitor.cpp, hwDecalBumpShader_NV20/hwDecalBumpShader_NV20.cpp, hwDecalBumpShader_NV20/NodeMonitor.cpp, hwPhongShader/hwPhongShader.cpp, hwReflectBumpShader_NV20/hwReflectBumpShader_NV20.cpp, hwReflectBumpShader_NV20/NodeMonitor.cpp, hwRefractReflectShader_NV20/hwRefractReflectShader_NV20.cpp, hwRefractReflectShader_NV20/NodeMonitor.cpp, hwToonShader_NV20/hwToonShader_NV20.cpp, hwToonShader_NV20/NodeMonitor.cpp, hwUnlitShader/hwUnlitShader.cpp, hwUnlitShader/NodeMonitor.cpp, lensDistortionCallback/lensDistortionCallback.cpp, lockEvent/lockEvent.cpp, manipOverride/customTriadManip.cpp, manipOverride/manipOverride.cpp, moveManip/moveManip.cpp, nodeCreatedCBCmd/nodeCreatedCBCmd.cpp, nodeMessageCmd/nodeMessageCmd.cpp, paintCallback/paintCallback.cpp, pluginCallbacks/pluginCallbacks.cpp, polyMessageCmd/polyMessageCmd.cpp, rawfootPrintNode/rawfootPrintNode.cpp, renderViewInteractiveRenderCmd/renderViewInteractiveRenderCmd.cpp, rotateManip/rotateManip.cpp, ShapeMonitor/ShapeMonitor.cpp, surfaceBumpManip/surfaceBumpManip.cpp, transformDrawNode/transformDrawNode.cpp, viewCallbackTest/viewCallbackTest.cpp, and viewRenderOverride/viewRenderOverride.cpp.

MStatus removeCallbacks ( MCallbackIdArray & idList )

static

Remove all of the specified callbacks from maya.

This method must be called for all callbacks registered by a plug-in before that plug-in is unloaded.

Parameters

[in] idList identifier list of callbacks to be removed

Returns: Status code

Status Codes:

MS::kSuccess The callback was successfully removed.
MS::kInvalidParameter An invalid callback id was specfied.
MS::kFailure Callback has already been removed.

Examples:: cgFx/cgfxShaderNode.cpp, cgFx/pluginMain.cpp, deletedMsgCmd/deletedMsgCmd.cpp, fileIOMsgCmd/fileIOMsgCmd.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, testCameraSetCmd/testCameraSetCmd.cpp, transformDrawNode/transformDrawNode.cpp, and undoRedoMsgCmd/undoRedoMsgCmd.cpp.

MCallbackId currentCallbackId ( MStatus * ReturnStatus = NULL )

static

Return the callback ID of the currently executing callback.

If called outside of a callback, an invalid MCallbackId and failed status will be returned.

Parameters

[in] ReturnStatus Status code

Returns: Callback ID of currently executing callback

Status Codes:

MS::kSuccess The callbackId was successfully retrieved.
MS::kFailure This method was executed outside of a user callback.

Examples:: dagMessageCmd/dagMessageCmd.cpp.

MStatus nodeCallbacks	(	MObject &	node,
		MCallbackIdArray &	ids
	)

static

Returns a list of callback IDs associated registered to a given node.

Parameters

[in]	node	Node to query for callbacks.
[out]	ids	MCallbackId array to store the list of callback IDs.

Returns: Status Code

Status Codes:

MS::kSuccess The callback query was successful.
MS::kFailure The given node was invalid.

const char * className ( )

static

Returns the name of this class.

Returns: The name of this class.

MStatus removeCallbacks ( MIntArray & idList )

static

This method is obsolete. This method is not available in Python.

Deprecated:: Please use the other MMessage::removeCallbacks method.

Remove all of the specified callbacks from maya.

This method must be called for all callbacks registered by a plug-in before that plug-in is unloaded.

Parameters

[in] idList identifier of callback to be removed

Returns: Status code

Status Codes:

MS::kSuccess The callback was successfully removed.
MS::kInvalidParameter An invalid callback id was specfied.
MS::kFailure Callback has already been removed.

MStatus nodeCallbacks	(	MObject &	node,
		MIntArray &	ids
	)

static

This method is obsolete.

This method is not available in Python.

Deprecated:: Please use the other MMessage::nodeCallbacks method.

Returns a list of callback IDs associated registered to a given node.

Parameters

[in]	node	Node to query for callbacks.
[out]	ids	Integer array to store the list of callback IDs.

Returns: Status Code

Status Codes:

MS::kSuccess The callback query was successful.
MS::kFailure The given node was invalid.

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

MMessage.h
MMessage.cpp

MMessage Class Reference

Class Description

Public Types

Static Public Member Functions

Friends

Member Typedef Documentation

Member Enumeration Documentation

Member Function Documentation