3ds Max C++ API Reference
Loading...
Searching...
No Matches
RestoreObj Class Referenceabstract

#include <hold.h>

+ Inheritance diagram for RestoreObj:

Public Member Functions

 RestoreObj ()
 
virtual ~RestoreObj ()
 
virtual void Restore (int isUndo)=0
 
virtual void Redo ()=0
 
virtual int Size ()
 
virtual void EndHold ()
 
virtual MSTR Description ()
 
virtual bool MarkSceneDirtyForSave () const
 
virtual INT_PTR Execute (int cmd, ULONG_PTR arg1=0, ULONG_PTR arg2=0, ULONG_PTR arg3=0)
 
- Public Member Functions inherited from InterfaceServer
virtual UtilExport ~InterfaceServer ()
 Destructor.
 
virtual UtilExport BaseInterfaceGetInterface (Interface_ID id)
 
template<class InterfaceType >
InterfaceType * GetTypedInterface ()
 

Friends

class HoldStore
 
class GenUndoObject
 
class CheckForFlush
 
class UndoMgrBody
 

Additional Inherited Members

- Static Public Member Functions inherited from MaxHeapOperators
static UtilExport voidoperator new (size_t size)
 Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown.
 
static UtilExport voidoperator 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 voidoperator 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 voidoperator 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 voidoperator 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 voidoperator 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 voidoperator 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 voidoperator new[] (size_t size)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
 
static UtilExport voidoperator 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 voidoperator 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 voidoperator new[] (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate arrays of objects.
 
static UtilExport voidoperator 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 voidoperator 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 voidoperator 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 voidoperator 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 voidaligned_malloc (size_t size, size_t alignment)
 Allocates memory on a specified alignment boundary.
 
static UtilExport voidaligned_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

See also
Class Hold, The Undo and Redo System.

Description:
This class is the restore object used in the undo / redo system of 3ds Max.

Constructor & Destructor Documentation

◆ RestoreObj()

RestoreObj ( )
inline
43{ next = prev = NULL; }
#define NULL
Definition: autoptr.h:18

◆ ~RestoreObj()

virtual ~RestoreObj ( )
inlinevirtual
44{};

Member Function Documentation

◆ Restore()

virtual void Restore ( int  isUndo)
pure virtual
Remarks
The developer implements this method to restore the state of the database to as it was when theHold.Put() was called with this restore object.

Regardless of the value of the isUndo parameter, the method must restore the state of the scene to the one it was in when theHold.Put() was called with this restore object.

RestoreObj::Restore and RestoreObj::Redo may be called several times in a row: these methods must protect against any problems that may arise because of this, such as trying to undo multiple times in a row what has been undone already.
Parameters
isUndoNonzero if Restore() is being called in response to the Undo command; otherwise zero. If isUndo is nonzero, the developer needs to save whatever data they need to allow the user to redo the operation.

Implemented in JPLimitsRestore, PatchObjectRestore, RealWorldScaleRecord< T >, RefMgrAddDeleteRestore< T >, AppendGizmoRestore, DeleteGizmoRestore, ConvertToRestore, AssignControllerRestore, and DeletedRestore.

◆ Redo()

virtual void Redo ( )
pure virtual
Remarks
This method is called when the user selects the Redo command. The developer should restore the database to the state prior to the last Undo command.

Implemented in JPLimitsRestore, PatchObjectRestore, RealWorldScaleRecord< T >, RefMgrAddDeleteRestore< T >, AppendGizmoRestore, DeleteGizmoRestore, ConvertToRestore, AssignControllerRestore, and DeletedRestore.

◆ Size()

virtual int Size ( )
inlinevirtual
Remarks
Returns the size of the restore object in bytes. This size does not need to be exact but should be close. This is used to make sure all the accumulated restore objects do not grow beyond a manageable size.
Default Implementation:
{ return 1; }
Returns
The size of the restore object in bytes.

Reimplemented in PatchObjectRestore.

70{ return sizeof(RestoreObj); }
RestoreObj()
Definition: hold.h:43

◆ EndHold()

virtual void EndHold ( )
inlinevirtual
Remarks
This method is called when theHold.Accept() or theHold.Cancel() is called. This means the restore object is no longer held, it was either tossed out or sent to the undo system. The developer may then call ClearAFlag(A_HELD) to indicate the restore object is no longer being held.

Reimplemented in JPLimitsRestore, and PatchObjectRestore.

76{ }

◆ Description()

virtual MSTR Description ( )
inlinevirtual
Remarks
This method is used internally to 3ds Max in debugging only. It is used to display a symbolic name for the restore object.
Returns
The name of the restore object.
Default Implementation:
{ return MSTR(_M("---")); }

Reimplemented in PatchObjectRestore, RefMgrAddDeleteRestore< T >, AppendGizmoRestore, DeleteGizmoRestore, ConvertToRestore, AssignControllerRestore, and DeletedRestore.

82{ return MSTR(_M("---")); }
#define _M(x)
Used to wrap string literals.
Definition: strbasic.h:67
WStr MSTR
Definition: strclass.h:1071

◆ MarkSceneDirtyForSave()

virtual bool MarkSceneDirtyForSave ( ) const
inlinevirtual
Remarks
This method is used to specify whether putting this restore object to the hold system should mark the scene dirty in terms of requiring a scene file save.
Returns
Whether to make the scene dirty in terms of requiring a scene file save.
87{ return true; }

◆ Execute()

virtual INT_PTR Execute ( int  cmd,
ULONG_PTR  arg1 = 0,
ULONG_PTR  arg2 = 0,
ULONG_PTR  arg3 = 0 
)
inlinevirtual
Remarks
This is a general purpose function that allows the API to be extended in the future. The 3ds Max development team can assign new cmd numbers and continue to add functionality to this class without having to 'break' the API.

This is reserved for future use.
Default Implementation:
{return -1;}
97 {
98 UNUSED_PARAM(cmd);
99 UNUSED_PARAM(arg1);
100 UNUSED_PARAM(arg2);
101 UNUSED_PARAM(arg3);
102 return -1;
103 }
#define UNUSED_PARAM(x)
Definition: BuildWarnings.h:18

Friends And Related Function Documentation

◆ HoldStore

friend class HoldStore
friend

◆ GenUndoObject

friend class GenUndoObject
friend

◆ CheckForFlush

friend class CheckForFlush
friend

◆ UndoMgrBody

friend class UndoMgrBody
friend