XmClipboardUnlock(3X)

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;


VERSION
     This page documents version 1.2 of the Motif library.

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 re-
     move_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 ob-
                 tained 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 re-
                 moved.


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), Xm-
     ClipboardEndRetrieve(3X), XmClipboardInquireCount(3X), XmClipboardInquire-
     Format(3X), XmClipboardInquireLength(3X), XmClipboardInquirePendin-
     gItems(3X), XmClipboardLock(3X), XmClipboardRegisterFormat(3X), XmClip-
     boardRetrieve(3X), XmClipboardStartCopy(3X), XmClipboardStartRetrieve(3X),
     XmClipboardUndoCopy(3X), and XmClipboardWithdrawFormat(3X).

                                                           XmClipboardUnlock(3X)