LAnnAutomation::GetUndoDepth

#include "ltwrappr.h"

virtual L_INT LAnnAutomation::GetUndoDepth(puUsedLevels, puMaxLevels)

L_UINT * puUsedLevels;

/* address of a variable to be updated */

L_UINT * puMaxLevels;

/* address of a variable to be updated */

Retrieves the number of user actions that can be reversed using the LAnnAutomation::Undo function.

Parameter

Description

hObject

Handle to the automation object.

puUsedLevels

Address of a variable to be updated with the number or user actions that can be reversed using LAnnAutomation::Undo. This number will be between 0 and the number retrieved in puMaxLevels.

puMaxLevels

Address of a variable to be updated with the maximum number of user actions that can be undone using LAnnAutomation::Undo. This is the value that was set using LAnnAutomation::SetUndoDepth.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

If puUsedLevels is updated with a value of 0, no user actions can be undone using the LAnnAutomation::Undo function.

Required DLLs and Libraries

LTANN

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:

LAnnAutomation::SetUndoDepth, LAnnAutomation::Undo

Topics:

Annotation Functions: Working with the Toolbar

 

Implementing Annotations

 

Automated User Interface for Annotations

Example

//This example uses the following member variables:

// m_AnnotationWindow should be created and initialized prior to the example

L_INT LAnnAutomation_GetUndoDepthExample(LAnnotationWindow m_AnnotationWindow) 
{
   L_INT nRet;
   L_UINT uUsedLevels, uMaxLevels;
   L_TCHAR szMsg[100];
   nRet = m_AnnotationWindow.GetAutomationObject().GetUndoDepth(&uUsedLevels, &uMaxLevels);
   if(nRet != SUCCESS)
      return nRet;
   wsprintf(szMsg,TEXT("UsedLevels[%d]\nMaxLevels[%d]"), uUsedLevels, uMaxLevels);
   AfxMessageBox(szMsg);
   return SUCCESS;
}