DwtCancelCopyFormat(3Dwt) DwtCancelCopyFormat(3Dwt)
Name
DwtCancelCopyFormat - Indicates that the application will no longer supply a data item to the clipboard that the application had previously
passed by name.
Syntax
int DwtCancelCopyFormat(display, window, data_id)
Display *display;
Window window;
int data_id;
Arguments
display Specifies a pointer to the Display structure that was returned in a previous call to XOpenDisplay. For information on XOpenDis-
play and the Display structure, see the Guide to the Xlib Library: C Language Binding.
window Specifies the window ID that relates the application window to the clipboard. The same application instance should pass the same
window ID to each clipboard function that it calls.
data_id 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 DwtCopyToClipboard.
Description
The DwtCancelCopyFormat function indicates that the application will no longer supply a data item to the clipboard that the application had
previously passed by name.
Return Values
This function returns one of these status return constants:
ClipboardSuccess The function is success-
ful.
ClipboardLocked The function failed
because the clipboard was
locked by another appli-
cation. The application
can continue to call the
function with the same
parameters until the
clipboard is unlocked.
Optionally, the applica-
tion can ask if the user
wants to keep trying or
to give up on the opera-
tion.
See Also
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtCancelCopyFormat(3Dwt)
