Man Linux: Main Page and Category List

NAME

       XmClipboardUndoCopy  —  A clipboard function that deletes the last item
       placed on the clipboard

SYNOPSIS

       #include <Xm/CutPaste.h>
       int XmClipboardUndoCopy (display, window)
               Display * display;
               Window  window;
       (void)

DESCRIPTION

       XmClipboardUndoCopy deletes the last item placed on  the  clipboard  if
       the item was placed there by an application with the passed display and
       window arguments. Any data item  deleted  from  the  clipboard  by  the
       original  call to XmClipboardCopy is restored. If the display or window
       IDs do not match the last copied item, no action  is  taken,  and  this
       function has no effect.

       display   Specifies  a  pointer  to  the  Display  structure  that  was
                 returned in a previous call to XOpenDisplay or XtDisplay.

       window    Specifies  the  window  ID  of  a  widget  that  relates  the
                 application  window  to the clipboard. The widget’s window ID
                 can be  obtained  through  XtWindow.   The  same  application
                 instance  should  pass  the  same window ID to each clipboard
                 function it calls.

RETURN

       XmClipboardSuccess
                 The function was successful.

       XmClipboardLocked
                 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

       XmClipboardLock(3) and XmClipboardStartCopy(3).

                                             XmClipboardUndoCopy(library call)