- Main Page
- Related Pages
- Modules
- Namespaces
- Classes
- Examples

- Class List
- Class Hierarchy
- Class Members

Public Member Functions | Static Public Member Functions | Protected Member Functions

# MPxSelectionContext Class Reference
OpenMayaUI - API module for user interface | Proxy classes

This reference page is linked to from the following overview topics: Connect Manipulators to the Show Manipulator Tool.

Search for all occurrences

## Detailed Description

Base class for interative selection tools.

This class is used in creating user defined tools that use the internal selection mechanism in maya.

Examples:

  componentScaleManip.cpp, customAttrManip.cpp, meshRemapTool.h, meshReorderTool.h, moveManip.cpp, moveNumericTool.cpp, moveTool.cpp, rotateManip.cpp, and surfaceBumpManip.cpp.

`#include <MPxSelectionContext.h>`

Inheritance diagram for MPxSelectionContext:
[legend]

List of all members.

## Public Member Functions
| MPxSelectionContext ()
| Class contstructor.
virtual | ~MPxSelectionContext ()
| Default destructor.
virtual MStatus | doPress (MEvent &event)
| This method is called when any mouse button is pressed.
virtual MStatus | doRelease (MEvent &event)
| This method is called when any mouse button is released.
virtual MStatus | doDrag (MEvent &event)
| This method is called when a mouse drag event occurs.
virtual MStatus | doHold (MEvent &event)
| This method is called when after a mouse button is pressed but before the mouse is dragged.
virtual MStatus | helpStateHasChanged (MEvent &)
| This method is called whenever the help state may need to be updated.
virtual MStatus | addManipulator (const MObject &manipulator)
| This method adds a manipulator to the context, and also adds the manipulator to the DAG.
virtual MStatus | deleteManipulators ()
| This method deletes all the manipulators that belong to the context.
MStatus | setImage (const MString &image, ImageIndex index)
| This method is used to set an XPM icon image that is to be used to represent this tool context in various places including the tool bar and can be queried from mel using the contextInfo command.
MString | image (ImageIndex index, MStatus *ReturnStatus=NULL) const
| This method is used to retrieve an XPM icon image that has previously been set for this tool context.
MStatus | getImage (MString &image, ImageIndex index) const
| NO SCRIPT SUPPORT.
virtual void | abortAction ()
| This method is called when the abort key is pressed.
virtual bool | processNumericalInput (const MDoubleArray &values, const MIntArray &flags, bool isAbsolute)
| This method processes the input from the numerical input field.
virtual bool | feedbackNumericalInput () const
| This method is called to update the numerical feedback.
virtual MSyntax::MArgType | argTypeNumericalInput (unsigned int index) const
| This method is used by the feedback line to determine what units to display.
## Static Public Member Functions
static const char * | className ()
| Returns the name of this class.
## Protected Member Functions
bool | isSelecting ()
| USE _isSelecting() IN SCRIPT.
MPoint | startPoint ()
| USE _startPoint() IN SCRIPT.
MPoint | lastDragPoint ()
| USE _lastDragPoint() IN SCRIPT.
virtual MPxToolCommand * | newToolCommand ()
| CALL _newToolCommand() IN SCRIPT.

## Constructor & Destructor Documentation

MPxSelectionContext | ( |  | ) |

Class contstructor.

This constructor will only be called from MPxContextCommand::makeObj. Users must override this method.

~MPxSelectionContext | ( |  | ) | `[virtual]`

Default destructor.

Users can override this method to free any user instantiated data when the context is destroyed.

## Member Function Documentation

MStatus doPress | ( | MEvent & | event | ) | `[virtual]`

Search for all occurrences

This method is called when any mouse button is pressed.

The base method does nothing and should be overriden if the user needs to do anything on a button press.

The event can be used to get more explicit information about the press such as the button number. See MEvent for more information.

Parameters:

  [in] | event | The button press event information.

Returns:
  Status code

Status Codes:
  - MS::kSuccess

Reimplemented from MPxContext.

Examples:
  moveNumericTool.cpp, and moveTool.cpp.

MStatus doRelease | ( | MEvent & | event | ) | `[virtual]`

Search for all occurrences

This method is called when any mouse button is released.

The base method does nothing except marquee selection and should be overriden if the user needs to do anything on a button release.

The event can be used to get more explicit information about the release such as the button number. See MEvent for more information.

Parameters:

  [in] | event | The mouse button release information.

Returns:
  Status code

Status Codes:
  - MS::kSuccess

Reimplemented from MPxContext.

Examples:
  meshRemapTool.cpp, meshRemapTool.h, meshReorderTool.cpp, meshReorderTool.h, moveNumericTool.cpp, and moveTool.cpp.

MStatus doDrag | ( | MEvent & | event | ) | `[virtual]`

Search for all occurrences

This method is called when a mouse drag event occurs.

The base method does nothing except marquee selection and should be overriden if the user needs to do anything during a mouse drag.

The event can be used to get more explicit information about the drag such as the cursor location. See MEvent for more information.

Parameters:

  [in] | event | The mouse drag event information.

Returns:
  Status code

Status Codes:
  - MS::kSuccess

Reimplemented from MPxContext.

Examples:
  moveNumericTool.cpp, and moveTool.cpp.

MStatus doHold | ( | MEvent & | event | ) | `[virtual]`

Search for all occurrences

This method is called when after a mouse button is pressed but before the mouse is dragged.

The base method does nothing except marquee selection and should be overriden if the user needs to do anything on a button hold.

The event can be used to get more explicit information about the hold such as the button number. See MEvent for more information.

Parameters:

  [in] | event | The mouse button hold event information.

Returns:
  Status code

Status Codes:
  - MS::kSuccess

Reimplemented from MPxContext.

MStatus helpStateHasChanged | ( | MEvent & | event | ) | `[virtual]`

Search for all occurrences

This method is called whenever the help state may need to be updated.

The base method does nothing and should be overriden if the user needs to change the help information based on events.

The event can be used to get more explicit information about the event. See MEvent for more information.

Parameters:

  [in] | event | The event information. Unused in the base class.

Returns:
  Status code

Status Codes:
  MS::kSuccess

Reimplemented from MPxContext.

Examples:
  meshRemapTool.h, and meshReorderTool.h.

MStatus addManipulator | ( | const MObject & | manipulator | ) | `[virtual]`

Search for all occurrences

This method adds a manipulator to the context, and also adds the manipulator to the DAG.

Note that the manipulator should not yet be added to the DAG when this method is called.

Parameters:

  [in] | manipulator | the manipulator to be added to the context

Returns:
  - MS::kSuccess operation successful
  - MS::kFailure operation failed

Reimplemented from MPxContext.

MStatus deleteManipulators | ( |  | ) | `[virtual]`

Search for all occurrences

This method deletes all the manipulators that belong to the context.

Returns:
  - MS::kSuccess operation successful
  - MS::kFailure operation failed

Reimplemented from MPxContext.

MStatus setImage | ( | const MString & | image,
|  | ImageIndex | index
| ) |  |

Search for all occurrences

This method is used to set an XPM icon image that is to be used to represent this tool context in various places including the tool bar and can be queried from mel using the contextInfo command.

Parameters:

  [in] | image | the name of an XPM file to be used as the icon
  [in] | index | the index of the image being set; three image representations are permitted: kImage1, kImage2, kImage3

Returns:
  - MS::kSuccess operation successful
  - MS::kFailure operation failed

Reimplemented from MPxContext.

MString image | ( | ImageIndex | index,
|  | MStatus * | ReturnStatus = `NULL`
| ) |  | const

Search for all occurrences

This method is used to retrieve an XPM icon image that has previously been set for this tool context.

This icon image will be used to represent this tool context in various places including the tool bar and can be queried from mel using the contextInfo command.

Parameters:

  [in] | index | the index for the image being retrieved; three image representations are permitted: kImage1, kImage2, kImage3
  [out] | ReturnStatus | Status code (see below)

Returns:
  String name

Status Codes:
  - MS::kSuccess operation successful
  - MS::kFailure operation failed

Reimplemented from MPxContext.

MStatus getImage | ( | MString & | image,
|  | ImageIndex | index
| ) |  | const

Search for all occurrences

NO SCRIPT SUPPORT.

This method is not available in Python.

This method is used to retrieve an XPM icon image that has previously been set for this tool context. This icon image will be used to represent this tool context in various places including the tool bar and can be queried from mel using the contextInfo command.

Python Notes

This method is not supported in Python. See the image function which returns a string.

Parameters:

  [in] | image | the returned name of an XPM Icon file
  [in] | index | the index for the image being retrieved; three image representations are permitted: kImage1, kImage2, kImage3

Returns:
  - MS::kSuccess operation successful
  - MS::kFailure operation failed

Reimplemented from MPxContext.

bool isSelecting | ( |  | ) | `[protected]`

Search for all occurrences

USE _isSelecting() IN SCRIPT.

Determines whether an object is selected.

Returns:
  true An object(s) is selected, false otherwise.

MPoint startPoint | ( |  | ) | `[protected]`

Search for all occurrences

USE _startPoint() IN SCRIPT.

Returns the position of button press.

Returns:
  The start point

MPoint lastDragPoint | ( |  | ) | `[protected]`

Search for all occurrences

USE _lastDragPoint() IN SCRIPT.

Returns the position of the last drag point.

Returns:
  The last drag point

MPxToolCommand * newToolCommand | ( |  | ) | `[protected, virtual]`

Search for all occurrences

CALL _newToolCommand() IN SCRIPT.

Create a new instance of the tool command associated with this context.

The tool command (derived from MPxToolCommand) is the command that was registered along with the context command in :

        MFnPlugin::registerContextCommand( contextCommand, contextCommandCreator,
                                           toolCommand, toolCommandCreator )

Returns:
  A new instance of the MPxToolCommand.

Reimplemented from MPxContext.

void abortAction | ( |  | ) | `[virtual]`

Search for all occurrences

This method is called when the abort key is pressed.

The default abort key in Maya is the escape key. Users can override this method if they wish to perform certain operations when the abort key is pressed.

Reimplemented from MPxContext.

bool processNumericalInput | ( | const MDoubleArray & | values,
|  | const MIntArray & | flags,
|  | bool | isAbsolute
| ) |  | `[virtual]`

Search for all occurrences

This method processes the input from the numerical input field.

Users can override this method if they wish to process numerical input. For a given entry in the numeric input field, if the user types a dot ".", this indicates that the entry should not be modified. The overridden version of this method should take this into account using the ignoreEntry method with the flags that are passed in. The overridden version of this method should also process the numeric input as an absolute input or relative input depending on whether the isAbsolute flag is true or not. The return value should indicate whether or not the numerical input has been processed.

Parameters:

  [in] | values | the values from the numerical input field
  [in] | flags | used in conjunction with the ignoreEntry method, determines whether or not a given entry should be ignored
  [in] | isAbsolute | whether or not the input should be interpreted as absolute

Returns:
  false the default return value.

Reimplemented from MPxContext.

Examples:
  moveNumericTool.cpp.

bool feedbackNumericalInput | ( |  | ) | const`[virtual]`

Search for all occurrences

This method is called to update the numerical feedback.

The format and values for the feedback line can be set through the methods in MFeedbackLine, specifically setFormat and setValue. The return value should indicate whether or not the numerical feedback has been provided.

Returns:
  false the default return value

Reimplemented from MPxContext.

Examples:
  moveNumericTool.cpp.

MSyntax::MArgType argTypeNumericalInput | ( | unsigned int | index | ) | const`[virtual]`

Search for all occurrences

This method is used by the feedback line to determine what units to display.

Users should override this method to return the appropriate argument type for the given index of the numeric input field. Specifically, this method should be overridden to return one of the following:

- MSyntax::kNoArg for no argument
- MSyntax::kDistance for linear units
- MSyntax::kAngle for angular units

Parameters:

  [in] | index | the index of the numerical input whose argument type is requested

Returns:
  MSyntax::kNoArg the default return value

Reimplemented from MPxContext.

Examples:
  moveNumericTool.cpp.

const char * className | ( |  | ) | `[static]`

Search for all occurrences

Returns the name of this class.

Returns:
  Name of this class.

Reimplemented from MPxContext.

MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext
MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext MPxSelectionContext