L_AutCut

#include "ltaut.h"

L_LTAUT_API L_INT L_AutCut(pAutomation, dwFlags )

pAUTOMATIONHANDLE pAutomation ;

/* pointer to an automation handle */

L_UINT32 dwFlags ;

/* reserved */

Cuts the selected objects in the active automation container to the Windows clipboard.

Parameter

Description

pAutomation

Pointer to an automation handle.

dwFlags

Reserved for future use. Must be 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To paste automation data on the clipboard to the active automation container, call L_AutPaste.

To copy automation data from the active automation container, to the Windows clipboard, use L_AutCopy.

To determine whether or not there is valid automation data present on the clipboard, call L_AutClipboardDataReady.

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_AutPaste, L_AutSetPaintBkColor, L_AutCopy, L_AutClipboardDataReady

Topics:

Editing Automation Containers

Example

This example shows how to do a cut operation to the current automation selection.

 L_INT AutCutExample( pAUTOMATIONHANDLE pAutomation )
{
   L_INT nRet;
   nRet = L_AutIsValid ( pAutomation );
   if ( SUCCESS == nRet ) /* check the validity of the automation handle */
   {
      /* cut the current selection to the clipboard */
      L_AutCut ( pAutomation, 0 ) ;

      return SUCCESS ;
   }
   else
   {
      return nRet ;
   }
}