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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmClipboardInquireCount -- A clipboard function that returns the	number
       of data item formats

SYNOPSIS
       #include	<Xm/CutPaste.h>
       int XmClipboardInquireCount (display, window, count,
	       max_format_name_length)
	       Display * display;
	       Window  window;
	       int     * count;
	       unsigned	long   * max_format_name_length;
       (void)

DESCRIPTION
       XmClipboardInquireCount returns the number of data item formats	avail-
       able for	the data item in the clipboard.	This function also returns the
       maximum name-length for all formats in which the	data item is stored.

       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.

       count	 Returns  the  number  of  data	item formats available for the
		 data item in the clipboard. If	no formats are available, this
		 argument equals 0 (zero). The count includes the formats that
		 were passed by	name.

       max_format_name_length
		 Specifies the maximum length of all format names for the data
		 item in the clipboard.

RETURN
       XmClipboardSuccess
		 The function was successful.

       XmClipboardLocked
		 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.

       XmClipboardNoData
		 The function could not	find data on the clipboard correspond-
		 ing to	the format requested. This  could  occur  because  the
		 clipboard  is	empty; there is	data on	the clipboard, but not
		 in the	requested format; or the data in the requested	format
		 was passed by name and	is no longer available.

RELATED
       XmClipboardStartCopy(3).

						    XmClipboardInquireCount(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmClipboardInquireCount&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help