


XmTextFieldReplace(3X)				       XmTextFieldReplace(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTeexxttFFiieellddRReeppllaaccee - A TextField function that replaces part of a text
  string

SYNOPSIS


  ##iinncclluuddee <<XXmm//TTeexxttFF..hh>>
  vvooiidd XXmmTTeexxttFFiieellddR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tFFiieellddRReeppllaaccee replaces part of the text string in the TextField
  widget.  The character positions begin at zero and are numbered sequen-
  tially 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 TextField 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 TextField and its associated resources, see
  XXmmTTeexxttFFiieelldd((33XX)).

RELATED	INFORMATION
  XXmmTTeexxttFFiieelldd((33XX)).  XXmmTTeexxttFFiieellddRReeppllaacceeWWccss((33XX)).














