


XmTextCut(3X)							XmTextCut(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTeexxttCCuutt - A	Text function that copies the primary selection	to the clip-
  board	and deletes the	selected text

SYNOPSIS


  ##iinncclluuddee <<XXmm//TTeexxtt..hh>>
  BBoooolleeaann XXmmTTeexxttCCuutt ((_w_i_d_g_e_t, _t_i_m_e))
       WWiiddggeett	 _w_i_d_g_e_t;;
       TTiimmee	 _t_i_m_e;;

DESCRIPTION
  XXmmTTeexxttCCuutt copies the primary selected	text to	the clipboard and then
  deletes the primary selected text.  This routine calls the widget's
  XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk and verification callbacks, either XXmmNNmmooddiiffyyVVeerriiffyy--
  CCaallllbbaacckk or XXmmNNmmooddiiffyyVVeerriiffyyCCaallllbbaacckkWWccss, or both.  If both verification
  callback lists are registered, the procedures	of the XXmmNNmmooddiiffyyVVeerriiffyyCCaallll--
  bbaacckk list are	executed first and the resulting data is passed	to the XXmmNNmmoo--
  ddiiffyyVVeerriiffyyCCaallllbbaacckkWWccss	callbacks.

  _w_i_d_g_e_t Specifies the Text widget ID.

  _t_i_m_e	 Specifies the server time at which the	selection value	is to be
	 modified.  This should	be the time of the event which triggered this
	 request.  One source of a valid time stamp is the function XXttLLaasstt--
	 TTiimmeessttaammppPPrroocceesssseedd(()).

  For a	complete definition of Text and	its associated resources, see
  XXmmTTeexxtt((33XX)).

RETURN VALUE
  This function	returns	False if the primary selection is NULL,	if the _w_i_d_g_e_t
  doesn't own the primary selection, or	if the function	is unable to gain
  ownership of the clipboard selection.	 Otherwise, it returns True.

RELATED	INFORMATION
  XXmmTTeexxtt((33XX)).




















