ultrix man page for dwtinquirenextpastelength

DwtInquireNextPasteLength(3Dwt) 										   DwtInquireNextPasteLength(3Dwt)

Name
       DwtInquireNextPasteLength - Returns the length of the data stored under a specified format name for the next-paste item in the clipboard.

Syntax
       int DwtInquireNextPasteLength(display, window,
				     format_name, length)
	    Display *display;
	    Window window;
	    char *format_name;
	    unsigned long *length;

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.

       format_name
		 Specifies the name of the format for the next-paste item.

       length	 Specifies the length of the next data item in the specified format.  This argument equals zero if no data is found for the speci-
		 fied format, or if there is no item on the clipboard.

Description
       The DwtInquireNextPasteLength function returns the length of the data stored under a specified format name for  the  next  paste  clipboard
       data item.

       If no data is found for the specified format, or if there is no item on the clipboard, DwtInquireNextPasteLength returns a value of zero.

       Any  format  passed  by	name  is  assumed to have the length passed in a call to DwtCopyToClipboard, even though the data has not yet been
       transferred to the clipboard in that format.

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.
       ClipboardNoData	  Information  could not be
			  obtained from an applica-
			  tion	 using	 the  ICCCM
			  clipboard selection mech-
			  anism.  This return value
			  indicates that  the  data
			  was  not available in the
			  requested format.

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

														   DwtInquireNextPasteLength(3Dwt)