DwtClipboardUnlock(3Dwt) DwtClipboardUnlock(3Dwt)
Name
DwtClipboardUnlock - Unlocks the clipboard, enabling other applications to access it.
Syntax
int DwtClipboardUnlock(display, window, remove_all_locks)
Display *display;
Window window;
Boolean remove_all_locks;
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.
remove_all_locks
Specifies a boolean value that, when True, indicates that all nested locks should be removed. If False, indicates that only one
level of lock should be removed.
Description
The DwtClipboardUnlock function unlocks the clipboard, enabling it to be accessed by other applications.
If multiple calls to DwtClipboardLock have occurred, then the same number of calls to DwtClipboardUnlock is necessary to unlock the clip-
board, unless the remove_all_locks argument is True.
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
DwtClipboardLock(3Dwt)
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtClipboardUnlock(3Dwt)