Cuts the selected objects in the active automation container to the Microsoft Windows clipboard.
#include "ltaut.h"
L_LTAUT_API L_INT L_AutCut(pAutomation, dwFlags )
Pointer to an automation handle.
Reserved for future use. Must be 0.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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 there is valid automation data present on the clipboard, call L_AutClipboardDataReady.
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 ;
}
}