SDK X11 R4.11MU05 XmClipboardWithdrawFormat(3X)
NAME
XmClipboardWithdrawFormat--A clipboard function that indicates that
the application no longer wants to supply a data item
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/CutPaste.h>
int XmClipboardWithdrawFormat (display, window, dataid)
Display * display;
Window window;
long dataid;
DESCRIPTION
XmClipboardWithdrawFormat indicates that the application no longer
supplies a data item to the clipboard that the application had
previously passed by name.
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 clipboard function it calls.
dataid Specifies an identifying number assigned to the data item
that uniquely identifies the data item and the format.
This was assigned to the item when it was originally
passed by XmClipboardCopy.
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
XmClipboardCopy(3X) and XmClipboardStartCopy(3X).
Licensed material--property of copyright holder(s)