XmClipboardEndRetrieve(3X)UNIX System VXmClipboardEndRetrieve(3X)
NAME
XmClipboardEndRetrieve - A clipboard function that ends a
copy from the clipboard
SYNOPSIS
#include <Xm/Xm.h>
#include <Xm/CutPaste.h>
int XmClipboardEndRetrieve (display, window)
Display * display;
Window window;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTION
XmClipboardEndRetrieve suspends copying data incrementally
from the clipboard. It tells the clipboard routines that
the application is through copying an item from the
clipboard. Until this function is called, data items can be
retrieved incrementally from the clipboard by calling
XmClipboardRetrieve.
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.
RETURN VALUE
ClipboardSuccess
The function is successful.
ClipboardLocked
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.
RELATED INFORMATION
Page 1 (printed 4/30/98)
XmClipboardEndRetrieve(3X)UNIX System VXmClipboardEndRetrieve(3X)
XmClipboardRetrieve(3X), XmClipboardStartCopy(3X), and
XmClipboardStartRetrieve(3X).
Page 2 (printed 4/30/98)