


XmTextReplace(3X)					    XmTextReplace(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTeexxttRReeppllaaccee	- A Text function that replaces	part of	a text string

SYNOPSIS


  ##iinncclluuddee <<XXmm//TTeexxtt..hh>>
  vvooiidd XXmmTTeexxttRReeppllaaccee ((_w_i_d_g_e_t, _f_r_o_m__p_o_s,	_t_o__p_o_s,	_v_a_l_u_e))
       WWiiddggeett	   _w_i_d_g_e_t;;
       XXmmTTeexxttPPoossiittiioonn_f_r_o_m__p_o_s;;
       XXmmTTeexxttPPoossiittiioonn_t_o__p_o_s;;
       cchhaarr	   * _v_a_l_u_e;;

DESCRIPTION
  XXmmTTeexxttRReeppllaaccee	replaces part of the text string in the	Text widget.  The
  character positions begin at zero and	are numbered sequentially from the
  beginning of the text.

  An example text replacement would be to replace the second and third char-
  acters in the	text string.  To accomplish this, the parameter	_f_r_o_m__p_o_s must
  be 1 and _t_o__p_o_s must be 3.  To insert	a string after the fourth character,
  both parameters, _f_r_o_m__p_o_s and	_t_o__p_o_s,	must be	4.

  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yC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lbbaacckk list are executed first and the resulting
  data is passed to the	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 callbacks.

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

  _f_r_o_m__p_o_s
	 Specifies the start position of the text to be	replaced

  _t_o__p_o_s Specifies the end position of the text	to be replaced

  _v_a_l_u_e	 Specifies the character string	value to be added to the text widget

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

RELATED	INFORMATION
  XXmmTTeexxtt((33XX)) and XXmmTTeexxttRReeppllaacceeWWccss((33XX)).















