LAutomation::Cut

#include "ltwrappr.h"

L_INT LAutomation::Cut (dwFlags = 0)

L_UINT32 dwFlags;

/* reserved */

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

Parameter

Description

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 LAutomation::Paste.

To copy automation data from the active automation container, to the Windows clipboard, use LAutomation::Copy.

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

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:

LAutomation::Paste, LAutomation::Copy, LAutomation::ClipboardDataReady

Topics:

Editing Automation Containers

Example

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

L_INT LAutomation_CutExample(LAutomation &lauto)
{
   L_INT nRet;
   nRet = lauto.IsValid ();
   if ( SUCCESS == nRet ) /* check the validity of the automation handle */
   {
      /* cut the current selection to the clipboard */
      nRet = lauto.Cut() ;
      if(nRet != SUCCESS)
         return nRet;
   }
   else
   {
      return nRet ;
   }
   return SUCCESS ;
}