XmClipboardUndoCopy(3X)

NAME
     XmClipboardUndoCopy  -- A  clipboard  function  that  deletes the last item
     placed on the clipboard

SYNOPSIS
     #include <Xm/Xm.h>
     #include <Xm/CutPaste.h>

     int XmClipboardUndoCopy (display, window)
          Display   * display;
          Window    window;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmClipboardUndoCopy deletes the last item placed on the  clipboard  if  the
     item  was placed there by an application with the passed display and window
     arguments.  Any data item deleted from the clipboard by the  original  call
     to  XmClipboardCopy is restored.  If the display or window IDs do not match
     the last copied item, no action is taken, and this function has no effect.


     display     Specifies a pointer to the Display structure that was  returned
                 in a previous call to XOpenDisplay or XtDisplay.

     window      Specifies  a  widget's  window  ID that relates the application
                 window to the clipboard.  The widget's window  ID  can  be  ob-
                 tained by using XtWindow.  The same application instance should
                 pass the same window ID to each clipboard function it calls.


RETURN VALUE
     ClipboardSuccess
                 The function is successful.

     ClipboardLocked
                 The function failed because the clipboard was locked by another
                 application.  The application can continue to call the function
                 again  with the same parameters until the lock goes away.  This
                 gives the application the opportunity to ask if the user  wants
                 to keep trying or to give up on the operation.


RELATED INFORMATION
     XmClipboardLock(3X) and XmClipboardStartCopy(3X).

                                                         XmClipboardUndoCopy(3X)