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

FreeBSD Manual Pages


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

       XmClipboardLock -- A clipboard function that locks the clipboard

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

       XmClipboardLock	locks the clipboard from access	by another application
       until XmClipboardUnlock is called. All clipboard	functions lock and un-
       lock the	clipboard to prevent simultaneous access. This function	allows
       the application to keep the clipboard data from changing	between	 calls
       to Inquire and other clipboard functions. The application does not need
       to lock the clipboard between calls to XmClipboardStartCopy and XmClip-
       boardEndCopy or to XmClipboardStartRetrieve and XmClipboardEndRetrieve.

       If the clipboard	is already locked by another application, XmClipboard-
       Lock returns an error status. Multiple calls to this  function  by  the
       same application	increase the lock level.

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

       window	 Specifies the window ID of a widget that relates the applica-
		 tion  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	of the clipboard func-
		 tions that it calls.

		 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.

       XmClipboardEndCopy(3),	XmClipboardEndRetrieve(3),   XmClipboardStart-
       Copy(3),	XmClipboardStartRetrieve(3), and XmClipboardUnlock(3).



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

home | help