XmClipboardUnlock(Xm)
XmClipboardUnlock --
a clipboard function that unlocks the clipboard
Syntax
#include <Xm/Xm.h>
#include <Xm/CutPaste.h>
int XmClipboardUnlock (display, window, remove_all_locks)
Display * display;
Window window;
Boolean remove_all_locks;
Description
XmClipboardUnlock unlocks the clipboard,
enabling it to be accessed by other applications.
If multiple calls to XmClipboardLock have occurred, the same
number of calls to XmClipboardUnlock is necessary to unlock the clipboard,
unless remove_all_locks is set to True.
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.
remove_all_locks-
When True, indicates that all nested locks should be removed. When False,
indicates that only one level of lock should be removed.
Return value
ClipboardSuccess-
The function is successful.
ClipboardFail-
The function failed because the clipboard was not locked or was locked
by another application.
See also
XmClipboardCancelCopy(Xm),
XmClipboardCopy(Xm),
XmClipboardEndCopy(Xm),
XmClipboardEndRetrieve(Xm),
XmClipboardInquireCount(Xm),
XmClipboardInquireFormat(Xm),
XmClipboardInquireLength(Xm),
XmClipboardInquirePendingItems(Xm),
XmClipboardLock(Xm),
XmClipboardRegisterFormat(Xm),
XmClipboardRetrieve(Xm),
XmClipboardStartCopy(Xm),
XmClipboardStartRetrieve(Xm),
XmClipboardUndoCopy(Xm)
and
XmClipboardWithdrawFormat(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003