Class PostLoadCallback
See Also: Class ILoad, References.
class PostLoadCallback : public InterfaceServer
Description:
This is the callback object used by ILoad::RegisterPostLoadCallback(). The proc() method will be called when everything has been loaded and all the references are in place. It is assumed that if the callback needs to be deleted, the proc() method will do it.
Methods:
Prototype:
virtual void proc(ILoad *iload)=0;
Remarks:
Implemented by the Plug-In.
This method will be called when loading is complete.
Parameters:
ILoad *iload
This class provides methods to load data from disk.
Prototype:
virtual int Priority();
Remarks:
This method is available in release 3.0 and later only.
This method determines the order that the various registered callbacks execute. This method is overridden, for example, by the ParmBlock2 PostLoadCallbacks to return 1 so it can execute before the others.
Return Value:
The allowable return values are 0 to 10, with 5 being the default. 0 is reserved for ParamBlock2PLCB and ParamBlockPLCB..
Default Implementation:
{ return 5; }
Prototype:
virtual INT_PTR Execute(int cmd, ULONG arg1=0, ULONG arg2=0, ULONG arg3=0);
Remarks:
This method is available in release 3.0 and later only.
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.
Parameters:
int cmd
The command to execute.
ULONG arg1=0
Optional argument 1 (defined uniquely for each cmd).
ULONG arg2=0
Optional argument 2.
ULONG arg3=0
Optional argument 3.
Return Value:
An integer return value (defined uniquely for each cmd).
Default Implementation:
{ return 0; }