xmclipboardunlock(3x) [osf1 man page]

XmClipboardUnlock(3X)													     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;

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.	Specifies a pointer to the Display structure that was returned in a previous call to  XOpenDisplay
       or XtDisplay.  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.   When
       True, indicates that all nested locks should be removed.  When False, indicates that only one level of lock should be removed.

RETURN VALUE

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

SEE ALSO

       XmClipboardCancelCopy(3X),  XmClipboardCopy(3X),  XmClipboardEndCopy(3X),  XmClipboardEndRetrieve(3X), XmClipboardInquireCount(3X), XmClip-
       boardInquireFormat(3X),	XmClipboardInquireLength(3X),  XmClipboardInquirePendingItems(3X),  XmClipboardLock(3X),   XmClipboardRegisterFor-
       mat(3X),  XmClipboardRetrieve(3X), XmClipboardStartCopy(3X), XmClipboardStartRetrieve(3X), XmClipboardUndoCopy(3X), XmClipboardWithdrawFor-
       mat(3X)

															     XmClipboardUnlock(3X)

XmClipboardStartRetrieve(3X)											      XmClipboardStartRetrieve(3X)

NAME

       XmClipboardStartRetrieve - A clipboard function that starts a copy from the clipboard

SYNOPSIS

       #include <Xm/Xm.h> #include <Xm/CutPaste.h>

       int XmClipboardStartRetrieve (display, window, timestamp)
	       Display * display;
	       Window window;
	       Time timestamp;

DESCRIPTION

       XmClipboardStartRetrieve tells the clipboard routines that the application is ready to start copying an item from the clipboard.  The clip-
       board is locked by this routine and stays locked until XmClipboardEndRetrieve is called. Between a call to XmClipboardStartRetrieve  and  a
       call  to  XmClipboardEndRetrieve, multiple calls to XmClipboardRetrieve with the same format name result in data being incrementally copied
       from the clipboard until the data in that format has all been copied.

       The return value ClipboardTruncate from calls to XmClipboardRetrieve indicates that more data remains to be copied in the given format.	It
       is  recommended	that  any  calls to the Inquire functions that the application needs to make to effect the copy from the clipboard be made
       between the call to XmClipboardStartRetrieve and the first call to XmClipboardRetrieve.	That way, the application does not  need  to  call
       XmClipboardLock	and  XmClipboardUnlock.  Specifies a pointer to the Display structure that was returned in a previous call to XOpenDisplay
       or XtDisplay.  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.  Speci-
       fies the time of the event that triggered the copy. A valid timestamp must be supplied; it is not sufficient to use CurrentTime.

RETURN VALUE

       The function is successful.  The function failed because the clipboard was locked by another application.  The application can continue	to
       call  the  function again with the same parameters until the lock goes away.  This gives the application the opportunity to ask if the user
       wants to keep trying or to give up on the operation.

SEE ALSO

       XmClipboardEndRetrieve(3X),   XmClipboardInquireCount(3X),   XmClipboardInquireFormat(3X),    XmClipboardInquireLength(3X),    XmClipboard-
       InquirePendingItems(3X), XmClipboardLock(3X), XmClipboardRetrieve(3X), XmClipboardStartCopy(3X), XmClipboardUnlock(3X)

														      XmClipboardStartRetrieve(3X)