LAutomation::SetUndoEnabled

Summary

Disables or re-enables the undo feature of the automation handle.

Syntax

#include "ltaut.h"

L_INT LAutomation::SetUndoEnabled (bEnabled=TRUE);

Parameters

L_BOOL bEnabled

Flag that indicates whether to enable or disable the undo feature of the automation handle. By enabling or disabling the undo feature, the internal undo counter is incremented or decremented. Possible values are:

Value Meaning
TRUE Enable the undo feature and increment the internal undo counter by one.
FALSE Disable the undo feature and decrement the internal undo counter by one.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

This function sets an internal automation counter that determines whether the undo feature should be displayed. The undo feature is on only if this counter is greater than or equal to 0. The initial value is 0.

Use this function along with LAutomation::AddUndoNode to combine multiple operations into a single undo call. For more information on this process, refer to LAutomation::AddUndoNode.

Required DLLs and Libraries

See Also

Functions

Topics

Example

This example shows how enable/disable the undo stack.

L_INT LAutomation_SetUndoEnabledExample(LAutomation  &Automation) 
{ 
   L_INT nRet; 
 
   //check the validity of the automation handle  
 
   nRet = Automation .IsValid (); 
 
   if ( SUCCESS == nRet ) 
   { 
 
      // Disable recording of undo operations  
 
     nRet = Automation.SetUndoEnabled(FALSE); 
     if(nRet != SUCCESS) 
        return nRet; 
 
     // Do any vector operations that will not be added to the undo stack  
 
     // Enable recording of undo operations  
 
     nRet = Automation.SetUndoEnabled(); 
     if(nRet != SUCCESS) 
        return nRet; 
 
   } 
   else 
 
   { 
 
      return nRet; 
 
   } 
 
     return SUCCESS; 
} 

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Container and Automation C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.