#include <iparamm2.h>

Class Description

See also: Class IParamBlock2, Class ParamBlockDesc2, Class ParamMap2UserDlgProc.

Description:: This class provides methods to work with parameter map2s. Methods are provided for things like invalidating the parameter map so it gets redrawn, working with the parameter blocks associated with the parameter map, and establishing an optional dialog proc to handle controls not directly handled by the parameter map. This section also documents several functions that are available for creating and destroying parameter maps but are not part of this class.

Note: The use of this class requires the explicit inclusion the IPARAMM2.H header file.

Inheritance diagram for IParamMap2:

Public Member Functions
virtual void	Invalidate ()=0

virtual void	Validate ()=0

virtual void	Invalidate (ParamID id, int tabIndex=0)=0

virtual void	UpdateUI (TimeValue t)=0

virtual void	RedrawViews (TimeValue t, DWORD flag=REDRAW_NORMAL)=0

virtual Interval &	Validity ()=0

virtual void	SetParamBlock (IParamBlock2 *pb)=0
	Makes the parameter map point to a new parameter block, updating the user interface in the process. More...

virtual void	SetParamBlock (IParamBlock2 pb, ReferenceMaker owner)=0
	Makes the parameter map point to a new parameter block, updating the user interface in the process. More...

virtual MapID	GetMapID ()=0

virtual void	SetUserDlgProc (ParamMap2UserDlgProc *proc=NULL)=0

virtual ParamMap2UserDlgProc *	GetUserDlgProc ()=0

virtual void	ReplaceParam (ParamID curParam, ParamID newParam)

virtual HWND	GetHWnd ()=0

virtual MaxSDK::QMaxParamBlockWidget *	GetQWidget () const =0
	Returns the Qt widget being controlled by this parameter map, if applicable. More...

virtual IRollupWindow *	GetIRollup ()

virtual IParamBlock2 *	GetParamBlock ()=0

virtual BOOL	DlgActive ()=0

virtual ParamBlockDesc2 *	GetDesc ()=0

virtual void	ActivateDlg (BOOL onOff)=0

virtual int	FindSubTexFromHWND (HWND hw)=0

virtual int	FindSubMtlFromHWND (HWND hw)=0

virtual void	Enable (ParamID id, BOOL onOff, int tabIndex=0)=0

virtual void	SetText (ParamID id, const MCHAR *txt, int tabIndex=0)=0

virtual void	SetTooltip (ParamID id, bool bEnable, const MCHAR *txt, int tabIndex=0)=0
	Set tooltip of param UI control. More...

virtual void	SetRange (ParamID id, float low, float high, int tabIndex=0)=0

virtual void	Show (ParamID id, BOOL showHide, int tabIndex=0)=0

virtual void	SetThing (ReferenceTarget *m)=0

Public Member Functions inherited from InterfaceServer
virtual UtilExport	~InterfaceServer ()
	Destructor. More...

virtual UtilExport BaseInterface *	GetInterface (Interface_ID id)

Additional Inherited Members
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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

static UtilExport void *	operator new[] (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate arrays of objects. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

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. More...

static UtilExport void *	operator new (size_t size, void *placement_ptr)
	Placement new operator. More...

static UtilExport void	operator delete (void ptr, void placement_ptr)
	Placement delete operator. More...

static UtilExport void *	aligned_malloc (size_t size, size_t alignment)
	Allocates memory on a specified alignment boundary. More...

static UtilExport void *	aligned_realloc (void *ptr, size_t size, size_t alignment)
	Reallocates memory on a specified alignment boundary. More...

static UtilExport void	aligned_free (void *ptr)
	Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. More...

Member Function Documentation

virtual void Invalidate ( )

pure virtual

Remarks: This method marks the user interface as needing to be updated. This affects the entire UI for the parameter map.

virtual void Validate ( )

pure virtual

Remarks: This methods un-invalidates the entire user interface.

virtual void Invalidate	(	ParamID	id,
		int	tabIndex = `0`
	)

pure virtual

Remarks: This methods marks a specific control in the UI as requiring an update.

Parameters

id	The permanent ID of the control requiring an update.
tabIndex	If the control is a Tab<> then this is the zero based index into the table of the value to be invalidated.

virtual void UpdateUI ( TimeValue t )

pure virtual

Remarks: This method will update the user interface if the current settings are not valid at the given time (i.e., if anything is animated at that time).

Parameters

t	The time to check for the update.

virtual void RedrawViews	(	TimeValue	t,
		DWORD	flag = `REDRAW_NORMAL`
	)

pure virtual

Remarks: This method may be called to cause the viewports to be redrawn.

Parameters

t	The time at which to redraw the viewports.
flag	You may specify one of the following: REDRAW_BEGIN Call this before you redraw. REDRAW_INTERACTIVE This allows the view quality to degrade to maintain interactively. REDRAW_END If during interactive redraw the state degraded, this will redraw the views in the undegraded state. REDRAW_NORMAL This redraws the views in the undegraded state.

virtual Interval& Validity ( )

pure virtual

Remarks: Provides access to pmap's validity interval. Returns a refernce to the actual interval so it can be modified if desired.

virtual void SetParamBlock ( IParamBlock2 * pb )

pure virtual

Makes the parameter map point to a new parameter block, updating the user interface in the process.

Remarks: Consider calling SetParamBlock(IParamBlock2 pb, ReferenceMaker owner) instead.

Parameters

pb	The new parameter block to use with the parameter map.

Remarks: This method swaps the existing parameter block with a new

virtual void SetParamBlock	(	IParamBlock2 *	pb,
		ReferenceMaker *	owner
	)

pure virtual

Makes the parameter map point to a new parameter block, updating the user interface in the process.

Parameters

pb	The new parameter block to use with the parameter map.
owner	The owner the parameter block. In most cases, this should be IParamBlock2::GetOwner(). But in the case of class parameter block (see P_CLASS_PARAMS), where the parameter block does not have an owner, then this should point to the object for which the UI is currently being edited.

virtual MapID GetMapID ( )

pure virtual

Remarks: Returns the parameter map's ID.

virtual void SetUserDlgProc ( ParamMap2UserDlgProc * proc = NULL )

pure virtual

Remarks: This method allows a developer to provide special handling for one or more controls. The developer provides a dialog proc to process the message from the control. This method is used to tell the parameter map that the developer defined method should be called. The given proc will be called after default processing is done. Note that if the proc is non-NULL when the ParamMap2 is deleted its DeleteThis() method will be called.

Parameters

proc	Points to the user dialog proc object to process the controls.

virtual ParamMap2UserDlgProc* GetUserDlgProc ( )

pure virtual

Remarks: Returns a pointer to the user dialog proc for the parameter map (or NULL if none is defined). See SetUserDlgProc() above.

virtual void ReplaceParam	(	ParamID	curParam,
		ParamID	newParam
	)

inlinevirtual

Remarks: This method changes a parameter map entry to refer to a different item in the parameter block.

Parameters

curParam	The parameter ID of the item to change.
newParam	The new parameter ID.

179 { UNUSED_PARAM(curParam); UNUSED_PARAM(newParam); }

UNUSED_PARAM

#define UNUSED_PARAM(x)

Definition: BuildWarnings.h:18

virtual HWND GetHWnd ( )

pure virtual

Remarks: Returns the dialog window handle of the parameter map.

virtual MaxSDK::QMaxParamBlockWidget* GetQWidget ( ) const

pure virtual

Returns the Qt widget being controlled by this parameter map, if applicable.

This method will return a valid Qt widget only if the parameter map was constructed from a Qt widget. It will return null if the parameter map controls a Win32 dialog.

virtual IRollupWindow* GetIRollup ( )

inlinevirtual

189 { return NULL; }

NULL

#define NULL

Definition: autoptr.h:18

virtual IParamBlock2* GetParamBlock ( )

pure virtual

Remarks: Returns a pointer to the parameter block2 used by this parameter map.

virtual BOOL DlgActive ( )

pure virtual

Remarks: Returns TRUE if the parameter map dialog proc is active; otherwise FALSE.

virtual ParamBlockDesc2* GetDesc ( )

pure virtual

Remarks: Returns a pointer to the ParamBlockDesc2 instance for this parameter map.

virtual void ActivateDlg ( BOOL onOff )

pure virtual

Remarks: This method is called to indicate the dialog is going inactive or is becoming active.

Parameters

onOff TRUE if becoming active; FALSE for inactive.

virtual int FindSubTexFromHWND ( HWND hw )

pure virtual

Remarks: This method is sent to a Material Editor map to find the SubTex index corresponding to the control handle. It should return the index of the sub-texmap corresponding to the window whose handle is passed. If the handle is not valid return -1.

Parameters

hw	The window handle of the control.

virtual int FindSubMtlFromHWND ( HWND hw )

pure virtual

virtual void Enable	(	ParamID	id,
		BOOL	onOff,
		int	tabIndex = `0`
	)

pure virtual

Remarks: This method is used to enable of disable an individual user interface control.

Parameters

id	The parameter ID of the control to enable/disable.
onOff	TRUE to enable; FALSE to disable.
tabIndex	If the control is a Tab<> then this is the zero based index in the table of the item to enable/disable.

virtual void SetText	(	ParamID	id,
		const MCHAR *	txt,
		int	tabIndex = `0`
	)

pure virtual

Remarks: This method sets the text of a parameter user interface control.

Parameters

id	The ID of the parameter whose user interface text to change.
txt	The new string to display.
tabIndex	If the parmeter is a Tab<> this is the zero based index of the parameter in the table.

virtual void SetTooltip	(	ParamID	id,
		bool	bEnable,
		const MCHAR *	txt,
		int	tabIndex = `0`
	)

pure virtual

Set tooltip of param UI control.

This method allows for turning on or off the tooltip for a parameter user interface control.

Parameters

id	- The ID of the parameter whose user interface tooltip to set.
bEnable	- if true, the tooltip is enabled, otherwise disabled. When disabled, the tooltip won't be displayed when the the mouse hovers on top of the control. Enabling the tooltip repeatedly will have the same effect as enabling it once.
txt	- pointer to a string representing the text to be displayed in the tooltip window. This parameter is ignored when the tooltip is being disabled.
tabIndex	If the parameter is a Tab<> this is the zero based index of the parameter in the table.

virtual void SetRange	(	ParamID	id,
		float	low,
		float	high,
		int	tabIndex = `0`
	)

pure virtual

Remarks: This method sets the range of parameter for a spinner or slider control.

Parameters

id	The ID of the parameter.
low	The low range for the spinner / slider.
high	The high range for the spinner / slider.
tabIndex	If the parmeter is a Tab<> this is the zero based index of the parameter in the table.

virtual void Show	(	ParamID	id,
		BOOL	showHide,
		int	tabIndex = `0`
	)

pure virtual

Remarks: This method will show or hide the specified control.

Parameters

id	The ID of the parameter.
showHide	TRUE to show; FALSE to hide.
tabIndex	If the parmeter is a Tab<> this is the zero based index of the parameter in the table.

virtual void SetThing ( ReferenceTarget * m )

pure virtual

Remarks: This method is called by any IAutoXXParamDlg when it receives a SetThing().

Parameters

m	The item which was set.

IParamMap2 Class Reference

Class Description

Public Member Functions

Additional Inherited Members

Member Function Documentation