L_AutGetUndoLevel

#include "ltaut.h"

L_LTAUT_API L_INT L_AutGetUndoLevel(pAutomation, puLevel)

pAUTOMATIONHANDLE pAutomation;

/* pointer to an automation handle */

L_UINT * puLevel;

/* pointer to an integer */

Gets the undo level for the specified automation handle.

Parameter

Description

pAutomation

Pointer to the automation handle.

puLevel

A pointer to a variable to be updated with the undo level. The undo level is 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 [16].

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The undo level determines the number of automation operations that can be done within an automation container. The default value is DEF_AUTOMATION_UNDO_LEVEL [16]. If the undo level is set to 16, then each container associated with the automation handle has an undo level of 16.

To change the undo level call L_AutSetUndoLevel.

To undo an automation operation, call L_AutUndo.

To determine whether an automation operation can be undone, call L_AutCanUndo.

For information about grouping multiple operations into a single undo process, refer to L_AutAddUndoNode.

Required DLLs and Libraries

LTAUT

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_AutSetUndoLevel, L_AutUndo, L_AutCanUndo

Topics:

Undoing and Redoing Automation Operations

Example

For an example, refer to L_AutSetUndoLevel.