ViewportTextButton Class Reference

A simple text based button implementation of the IViewportButton. More...

#include <IViewportButton.h>

Inheritance diagram for ViewportTextButton:

Public Member Functions
CoreExport	ViewportTextButton ()
CoreExport	~ViewportTextButton ()
CoreExport bool	GetEnabled () const override
	Access to the enabled flag.
CoreExport void	SetEnabled (bool v) override
	Set the Enabled flag.
CoreExport MSTR	GetLabel () const override
	Access to the button text to be displayed in the viewport.
CoreExport void	SetLabel (const MSTR &label) override
	The developer simply sends in an unformated string, this class will then format it correct to [ XXXXX ].
CoreExport IPoint2	GetLocation () const override
	Get the current location for the button.
CoreExport void	SetLocation (const IPoint2 &loc) override
	Set the location of the button.
CoreExport void	SetColor (const Color &c) override
	The default color will be defined by Viewport Text CUI entry.
CoreExport Color	GetColor () const override
	Get the current color for the button.
CoreExport bool	ShowInActiveViewportOnly () override
	Defines whether the button is only shown in the current active viewport.
CoreExport bool	OnAction (HWND hwnd, GraphicsWindow *gw, IPoint2 hitLoc, IViewportButton::Action action) override
	Implementation of OnAction.
CoreExport bool	OnUpdate (HWND hwnd, ViewExp *vpt) override
	An update callback that can be used to update internal data structures.
CoreExport void	Display (TimeValue t, ViewExp *vpt, int flags) override
	Callback to display the button.
CoreExport void	GetViewportRect (TimeValue t, ViewExp *vpt, Rect *rect) override
	Get the viewport rect for the button.
Public Member Functions inherited from IViewportButton
	IViewportButton ()
virtual	~IViewportButton ()
virtual bool	GetEnabled () const =0
	Access to the enabled flag.
virtual void	SetEnabled (bool v)=0
	Set the Enabled flag.
virtual MSTR	GetLabel () const =0
	Access to the button text to be displayed in the viewport.
virtual void	SetLabel (const MSTR &label)=0
	Set the text to be displayed in the viewport.
virtual IPoint2	GetLocation () const =0
	Get the current location for the button.
virtual void	SetLocation (const IPoint2 &loc)=0
	Set the location of the button.
virtual void	SetColor (const Color &c)=0
	Set the color for the button to be used.
virtual Color	GetColor () const =0
	Get the current color for the button.
virtual bool	ShowInActiveViewportOnly ()=0
	Defines whether the button is only shown in the current active viewport.
virtual bool	OnAction (HWND hwnd, GraphicsWindow *gw, IPoint2 hitLoc, IViewportButton::Action action)=0
	A callback to allow the button to perform an action, such as pop up a menu, or run a function.
virtual bool	OnUpdate (HWND hwnd, ViewExp *vpt)=0
	An update callback that can be used to update internal data structures.
virtual void	Display (TimeValue t, ViewExp *vpt, int flags)=0
	Callback to display the button.
virtual void	GetViewportRect (TimeValue t, ViewExp *vpt, Rect *rect)=0
	Get the viewport rect for the button.

Protected Attributes
bool	mEnabled
MSTR	mButtonText
MSTR	mLabel
IPoint2	mLocation
Color	mColor
bool	mMouseOver
bool	mOldMouseOver

Additional Inherited Members
Public Types inherited from IViewportButton
enum	Action { eLeftClick = 0x0 , eRightClick , eMouseMove }
Static Public Member Functions inherited from MaxHeapOperators
static UtilExport void *	operator new (size_t size)
	Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, const std::nothrow_t &e)
	Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new (size_t size, const char *filename, int line)
	New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, const std::nothrow_t &e, const char *filename, int line)
	New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new (size_t size, unsigned long flags)
	New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new (size_t size, const std::nothrow_t &e, unsigned long flags)
	New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new[] (size_t size)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new[] (size_t size, const std::nothrow_t &e)
	New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new[] (size_t size, const char *filename, int line)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new[] (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate arrays of objects.
static UtilExport void *	operator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line)
	New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned.
static UtilExport void *	operator new[] (size_t size, unsigned long flags)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator new[] (size_t size, const std::nothrow_t &e, unsigned long flags)
	New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned.
static UtilExport void	operator delete (void *ptr)
	Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, const std::nothrow_t &e)
	Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete (void *ptr, const char *filename, int line)
	Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, int block_type, const char *filename, int line)
	Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line)
	Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete (void *ptr, unsigned long flags)
	Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags)
	Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete[] (void *ptr)
	Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, const std::nothrow_t &e)
	Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete[] (void *ptr, const char *filename, int line)
	Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, int block_type, const char *filename, int line)
	Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line)
	Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen.
static UtilExport void	operator delete[] (void *ptr, unsigned long flags)
	Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown.
static UtilExport void	operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags)
	Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown.
static UtilExport void *	operator new (size_t size, void *placement_ptr)
	Placement new operator.
static UtilExport void	operator delete (void *ptr, void *placement_ptr)
	Placement delete operator.
static UtilExport void *	aligned_malloc (size_t size, size_t alignment)
	Allocates memory on a specified alignment boundary.
static UtilExport void *	aligned_realloc (void *ptr, size_t size, size_t alignment)
	Reallocates memory on a specified alignment boundary.
static UtilExport void	aligned_free (void *ptr)
	Frees a block of memory that was allocated with aligned_malloc/aligned_realloc.

Detailed Description

A simple text based button implementation of the IViewportButton.

A new viewport text button that is used to cerate the new viewport buttons in 3ds max 2010 It create a [XXXXX] button format, and support mouse over high lights. Developers can derive from this class to provide their own actions and update functions. TO use this class you must import CORE.LIB into your projects.

Please read the IViewportButton help section for an explanation of the methods.

Constructor & Destructor Documentation

ViewportTextButton()

CoreExport ViewportTextButton

(

)

~ViewportTextButton()

CoreExport ~ViewportTextButton

(

)

Member Function Documentation

GetEnabled()

CoreExport bool GetEnabled ( ) const

overridevirtual

Access to the enabled flag.

Returns

TRUE if enabled

Implements IViewportButton.

SetEnabled()

CoreExport void SetEnabled ( bool  v )

overridevirtual

Set the Enabled flag.

If set to false, the button will not be drawn

Parameters

v	TRUE to enable, FALSE to disable the button.

Implements IViewportButton.

GetLabel()

CoreExport MSTR GetLabel ( ) const

overridevirtual

Access to the button text to be displayed in the viewport.

Returns

A string containing the current label to be displayed.

Implements IViewportButton.

SetLabel()

CoreExport void SetLabel ( const MSTR &  label )

overridevirtual

The developer simply sends in an unformated string, this class will then format it correct to [ XXXXX ].

Implements IViewportButton.

GetLocation()

CoreExport IPoint2 GetLocation ( ) const

overridevirtual

Get the current location for the button.

Returns

The location of the button

Implements IViewportButton.

SetLocation()

CoreExport void SetLocation ( const IPoint2 &  loc )

overridevirtual

Set the location of the button.

Parameters

loc	The new location for the button

Implements IViewportButton.

SetColor()

CoreExport void SetColor ( const Color &  c )

overridevirtual

The default color will be defined by Viewport Text CUI entry.

There is a new entry called Viewport Text Highlight that defines the mouse over color

Implements IViewportButton.

GetColor()

CoreExport Color GetColor ( ) const

overridevirtual

Get the current color for the button.

Returns

The current color

Implements IViewportButton.

ShowInActiveViewportOnly()

CoreExport bool ShowInActiveViewportOnly ( )

overridevirtual

Defines whether the button is only shown in the current active viewport.

Returns

TRUE if only drawn in the active viewport

Implements IViewportButton.

OnAction()

CoreExport bool OnAction ( HWND  hwnd, GraphicsWindow *  gw, IPoint2  hitLoc, IViewportButton::Action  action  )

overridevirtual

Implementation of OnAction.

Developers must perform hittesting in there derived function and update the mMouseOver flag, followed by calling the base implementation. This is to allow the mouse over highlighting to work.

Implements IViewportButton.

OnUpdate()

CoreExport bool OnUpdate ( HWND  hwnd, ViewExp *  vpt  )

overridevirtual

An update callback that can be used to update internal data structures.

The ViewportTextButton uses this to determine the Label to be used and location based on the current viewport being drawn.

Parameters

hwnd	The Window handle issueing the update request
vpt	A pointer to current View

Returns

TRUE if an update was implemented.

Implements IViewportButton.

Display()

CoreExport void Display ( TimeValue  t, ViewExp *  vpt, int  flags  )

overridevirtual

Callback to display the button.

The ViewportTextButton uses this to draw text into the viewport using GraphicsWindow API. All drawing should go through this API - no GDI.

Parameters

t	The current time
vpt	THe viewport to draw into
flags

Implements IViewportButton.

GetViewportRect()

CoreExport void GetViewportRect ( TimeValue  t, ViewExp *  vpt, Rect *  rect  )

overridevirtual

Get the viewport rect for the button.

Parameters

t	The current time
vpt	The active viewport
rect	The result of the viewport rect is stored here.

Implements IViewportButton.

Member Data Documentation

mEnabled

bool mEnabled

protected

mButtonText

MSTR mButtonText

protected

mLabel

MSTR mLabel

protected

mLocation

IPoint2 mLocation

protected

mColor

Color mColor

protected

mMouseOver

bool mMouseOver

protected

mOldMouseOver

bool mOldMouseOver

protected