[Contents]
[Index]
[Next]
[Previous]
XmClipboardUnlock
NAME
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 VALUE
- ClipboardSuccess
- The function is successful.
- ClipboardFail
- The function failed because the clipboard was not locked or was
locked by another application.
RELATED INFORMATION
XmClipboardCancelCopy(3X),
XmClipboardCopy(3X),
XmClipboardEndCopy(3X),
XmClipboardEndRetrieve(3X),
XmClipboardInquireCount(3X),
XmClipboardInquireFormat(3X),
XmClipboardInquireLength(3X),
XmClipboardInquirePendingItems(3X),
XmClipboardLock(3X),
XmClipboardRegisterFormat(3X),
XmClipboardRetrieve(3X),
XmClipboardStartCopy(3X),
XmClipboardStartRetrieve(3X),
XmClipboardUndoCopy(3X), and
XmClipboardWithdrawFormat(3X).