XmClipboardCancelCopy(Xm) UNIX System V
NAME
XmClipboardCancelCopy - a clipboard function that cancels a
copy to the clipboard.
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/CutPaste.h>
void XmClipboardCancelCopy (display, window, item_id)
Display * display;
Window window;
long item_id;
DESCRIPTION
XmClipboardCancelCopy cancels the copy to clipboard that is
in progress and frees up temporary storage. When a copy is
to be performed, XmClipboardStartCopy allocates temporary
storage for the clipboard data. XmClipboardCopy fills in
the appropriate data into the the temporary storage.
XmClipboardEndCopy copies the data to the clipboard
structure and frees up the temporary storage structures. If
XmClipboardCancelCopy is called, the XmClipboardEndCopy
function does not have to be called. A call to
XmClipboardCancelCopy is valid only after a call to
XmClipboardStartCopy and before a call to
XmClipboardEndCopy.
displaySpecifies 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.
item_idSpecifies the number assigned to this data item.
This number was returned by a previous call to
XmClipboardStartCopy.
RELATED INFORMATION
XmClipboardCopy(Xm), XmClipboardEndCopy(Xm), and
XmClipboardStartCopy(Xm).
(printed 2/14/90) XmClipboardCancelCopy(Xm)