


XmClipboardWithdrawFormat(3X)			XmClipboardWithdrawFormat(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCClliippbbooaarrddWWiitthhddrraawwFFoorrmmaatt - A	clipboard function that	indicates that the
  application no longer	wants to supply	a data item

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dWWiitthhddrraawwFFoorrmmaatt	((_d_i_s_p_l_a_y, _w_i_n_d_o_w, _d_a_t_a__i_d))
       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;;
       lloonngg	 _d_a_t_a__i_d;;

DESCRIPTION
  XXmmCClliippbbooaarrddWWiitthhddrraawwFFoorrmmaatt indicates that the application no longer supplies
  a data item to the clipboard that the	application had	previously passed by
  name.

  _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 clipboard function	it
	      calls.

  _d_a_t_a__i_d     Specifies	an identifying number assigned to the data item	that
	      uniquely identifies the data item	and the	format.	 This was
	      assigned to the item when	it was originally passed by XXmmCClliipp--
	      bbooaarrddCCooppyy.

RETURN VALUE

  CClliippbbooaarrddSSuucccceessss
	      The 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.

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











