


XmClipboardInquireCount(3X)			  XmClipboardInquireCount(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCClliippbbooaarrddIInnqquuiirreeCCoouunntt - A clipboard	function that returns the number of
  data item formats

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  ##iinncclluuddee <<XXmm//CCuuttPPaassttee..hh>>
  iinntt XXmmCClliippbbooaarrddIInnqquuiirreeCCoouunntt ((_d_i_s_p_l_a_y,	_w_i_n_d_o_w,	_c_o_u_n_t,
	    _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h))
       DDiissppllaayy	 * _d_i_s_p_l_a_y;;
       WWiinnddooww	 _w_i_n_d_o_w;;
       iinntt	 * _c_o_u_n_t;;
       uunnssiiggnneedd	lloonngg* _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h;;

DESCRIPTION
  XXmmCClliippbbooaarrddIInnqquuiirreeCCoouunntt returns the number of	data item formats available
  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.

  _d_i_s_p_l_a_y	  Specifies a pointer to the DDiissppllaayy structure that was
		  returned in a	previous call to XXOOppeennDDiissppllaayy or XXttDDiissppllaayy.

  _w_i_n_d_o_w	  Specifies a widget's window ID that relates the application
		  window to the	clipboard.  The	widget's window	ID can be
		  obtained by using XXttWWiinnddooww.  The same	application instance
		  should pass the same window ID to each of the	clipboard
		  functions that it calls.

  _c_o_u_n_t		  Returns the number of	data item formats available for	the
		  data item in the clipboard.  If no formats are available,
		  this argument	equals zero.  The count	includes the formats
		  that were passed by name.

  _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h
		  Specifies the	maximum	length of all format names for the
		  data item in the clipboard.

RETURN VALUE

  CClliippbbooaarrddSSuucccceessssThe function is successful.

  CClliippbbooaarrddLLoocckkeedd The function failed because the clipboard was	locked by
		  another 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.

  CClliippbbooaarrddNNooDDaattaa The function could not find data on the clipboard
		  corresponding	to the format requested.  This could occur
		  because the clipboard	is empty; there	is data	on the clip-
		  board	but not	in the requested format; or the	data in	the
		  requested format was passed by name and is no	longer avail-
		  able.


RELATED	INFORMATION
  XXmmCClliippbbooaarrddSSttaarrttCCooppyy((33XX)).
































































