Sets the automation undo level.
L_INT LAutomation::SetUndoLevel (uLevel);
An integer value that represents the maximum number of undo operations that can be performed in each container associated with the automation handle. The default value is DEF_AUTOMATION_UNDO_LEVEL .
|SUCCESS||The function was successful.|
|< 1||An error occurred. Refer to Return Codes.|
The undo level determines the number of automation operations that can be done within an automation container. If the undo level is set to the default value of DEF_AUTOMATION_UNDO_LEVEL , then each container associated with the automation handle has an undo level of 16.
To determine the current undo level, call LAutomation::GetUndoLevel.
To undo an automation operation, call LAutomation::Undo.
To determine whether an automation operation can be undone, call LAutomation::CanUndo.
For information about grouping multiple operations into a single undo process, refer to LAutomation::AddUndoNode.
This example shows how to Get/Set the automation undo level.
L_INT LAutomation_SetUndoLevelExample(LAutomation &lauto)
nRet = lauto. IsValid ();
if ( SUCCESS == nRet ) /* check the validity of the automation handle */
L_UINT uAutUndoLevel ;
/* get the current automation undo level */
uAutUndoLevel = lauto.GetUndoLevel () ;
if ( 32 != uAutUndoLevel )
/* set the automation undo level to 32 */
nRet = lauto.SetUndoLevel (32 ) ;
if(nRet != SUCCESS)
return nRet ;