XmClipboardUndoCopy(3Xm) XmClipboardUndoCopy(3Xm)
NAME
XmClipboardUndoCopy - a clipboard function that deletes
the last item placed on the clipboard.
AES SUPPORT LEVEL
full-use
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/CutPaste.h>
int XmClipboardUndoCopy (display, window)
Display * display;
Window window;
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 obtained by
using XtWindow. The same application
instance should pass the same window ID to
each of the clipboard functions that 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
- 1 -
XmClipboardUndoCopy(3Xm) XmClipboardUndoCopy(3Xm)
user wants to keep trying or to give up on
the operation.
RELATED INFORMATION
XmClipboardLock(3X) and XmClipboardStartCopy(3X).
- 2 -