Museum

 XmClipboardUnlock(Xm)          6 January 1993          XmClipboardUnlock(Xm)


 Name

    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
    removealllocks 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 win-
            dow 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.

    removealllocks
            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).