Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dwtclipboardlock(3dwt) [ultrix man page]

DwtClipboardLock(3Dwt)													    DwtClipboardLock(3Dwt)

Name
       DwtClipboardLock - Locks the clipboard from access by other applications.

Syntax
       int DwtClipboardLock(display, window)
	    Display *display;
	    Window window;

Arguments
       display	 Specifies  a pointer to the Display structure that was returned in a previous call to XOpenDisplay.  For information on XOpenDis-
		 play and the Display structure, see the Guide to the Xlib Library: C Language Binding.

       window	 Specifies the window ID that relates the application window to the clipboard.	The same application instance should pass the same
		 window ID to each clipboard function that it calls.

Description
       The  DwtClipboardLock  function	locks  the  clipboard from access by another application until you call DwtClipboardUnlock.  All clipboard
       functions lock and unlock the clipboard to prevent simultaneous access.	The DwtClipboardLock and DwtClipboardUnlock  functions	allow  the
       application to keep the clipboard data from changing between calls to the inquire functions and other clipboard functions.  The application
       does not need to lock the clipboard between calls to DwtBeginCopyToClipboard and DwtEndCopyToClipboard.

       If the clipboard is already locked by another application, DwtClipboardLock returns an error status.

       Multiple calls to DwtClipboardLock by the same application increase the lock level.

Return Values
       This function returns one of these status return constants:

       ClipboardSuccess   The function is  success-
			  ful.
       ClipboardLocked	  The	 function    failed
			  because the clipboard was
			  locked  by another appli-
			  cation.  The	application
			  can  continue to call the
			  function  with  the  same
			  parameters	until	the
			  clipboard  is   unlocked.
			  Optionally,  the applica-
			  tion can ask if the  user
			  wants  to  keep trying or
			  to give up on the  opera-
			  tion.

See Also
       DwtClipboardUnlock(3Dwt)
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

															    DwtClipboardLock(3Dwt)

Check Out this Related Man Page

DwtCancelCopyToClipboard(3Dwt)											    DwtCancelCopyToClipboard(3Dwt)

Name
       DwtCancelCopyToClipboard - Cancels the copy to clipboard that is in progress.

Syntax
       void DwtCancelCopyToClipboard(display, window, item_id)
	    Display *display;
	    Window window;
	    long item_id;

Arguments
       display	 Specifies  a pointer to the Display structure that was returned in a previous call to XOpenDisplay.  For information on XOpenDis-
		 play and the Display structure, see the Guide to the Xlib Library: C Language Binding.

       window	 Specifies the window ID that relates the application window to the clipboard.	The same application instance should pass the same
		 window ID to each clipboard function that it calls.

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

Description
       The  DwtCancelCopyToClipboard function cancels the copy to clipboard that is in progress.  DwtCancelCopyToClipboard also frees up temporary
       storage.  If DwtCancelCopyToClipboard is called, then DwtEndCopyToClipboard does not have to be called.	A call to DwtCancelCopyToClipboard
       is valid only after a call to DwtBeginCopyToClipboard and before a call to DwtEndCopyToClipboard.

See Also
       DwtBeginCopyToClipboard(3Dwt), DwtEndCopyToClipboard(3Dwt)
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

														    DwtCancelCopyToClipboard(3Dwt)
Man Page