XmClipboardUnlock(X3mot)


XmClipboardUnlock -- a clipboard function that unlocks the clipboard

Synopsis

#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 values


ClipboardSuccess
The function is successful.

ClipboardFail
The function failed because the clipboard was not locked or was locked by another application.

References

XmClipboardCancelCopy(X3mot), XmClipboardCopy(X3mot), XmClipboardEndCopy(X3mot), XmClipboardEndRetrieve(X3mot), XmClipboardInquireCount(X3mot), XmClipboardInquireFormat(X3mot), XmClipboardInquireLength(X3mot), XmClipboardInquirePendingItems(X3mot), XmClipboardLock(X3mot), XmClipboardRegisterFormat(X3mot), XmClipboardRetrieve(X3mot), XmClipboardStartCopy(X3mot), XmClipboardStartRetrieve(X3mot), XmClipboardUndoCopy(X3mot) and XmClipboardWithdrawFormat(X3mot).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004