Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmClipboardCancelCopy(3)   Library Functions Manual   XmClipboardCancelCopy(3)

       XmClipboardCancelCopy  --  A  clipboard function	that cancels a copy to
       the clipboard

       #include	<Xm/CutPaste.h>
       int XmClipboardCancelCopy (display, window, item_id)
	       Display * display;
	       Window  window;
	       long    item_id;

       XmClipboardCancelCopy cancels the copy to clipboard that	is in progress
       and  frees  up  temporary storage.  When	a copy is to be	performed, Xm-
       ClipboardStartCopy allocates temporary storage for the clipboard	 data.
       XmClipboardCopy	copies	the  appropriate  data	into the the temporary
       storage.	XmClipboardEndCopy copies the data to the clipboard  structure
       and  frees  up the temporary storage structures.	 If XmClipboardCancel-
       Copy is called, the XmClipboardEndCopy function does  not  have	to  be
       called.	A  call	to XmClipboardCancelCopy is valid only after a call to

       display	 Specifies a pointer to	the Display  structure	that  was  re-
		 turned	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	 through  XtWindow.   The  same	 application  instance
		 should	pass the same window ID	to each	of the clipboard func-
		 tions that it calls.

       item_id	 Specifies  the	number assigned	to this	data item. This	number
		 was returned by a previous call to XmClipboardStartCopy.

		 The function was successful.

		 The function failed because the clipboard was locked  by  an-
		 other	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.

		 The function  failed  because	XmClipboardStartCopy  was  not
		 called	or because the data item contains too many formats.

       XmClipboardCopy(3), XmClipboardEndCopy(3), and XmClipboardStartCopy(3).



Want to link to this manual page? Use this URL:

home | help