


DXmCSTextReplace(3X)					 DXmCSTextReplace(3X)



NAME
  DDXXmmCCSSTTeexxttRReeppllaaccee - Replaces a	specified segment of text in a compound
  string text widget.

SYNOPSIS

  DDXXmmCCSSTTeexxttSSttaattuuss DDXXmmCCSST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;;
		   iinntt	     _f_r_o_m__p_o_s;;
		   iinntt	     _t_o__p_o_s;;
		   XXmmSSttrriinngg  _v_a_l_u_e;;

PARAMETERS

  _w_i_d_g_e_t
      The identifier (widget ID) of the	compound string	text widget.

  _f_r_o_m__p_o_s
      An integer that represents the first character position of the text
      being replaced.

  _t_o__p_o_s
      An integer that represents the last character position of	the text
      being replaced.

  _v_a_l_u_e
      Replacement text for part	of the current text in the compound string
      text widget, or additional text to be inserted into the compound string
      text widget.

DESCRIPTION

  The DDXXmmCCSSTTeexxttRReeppllaaccee routine replaces	part of	the text in the	compound
  string text widget.  Within the widget, positions are	numbered starting at
  0 and	increasing sequentially.  For example, to replace the second and
  third	characters in the text,	_f_r_o_m__p_o_s should	be 1 and _t_o__p_o_s	should be 3.
  To insert text after the fourth character, _f_r_o_m__p_o_s and _t_o__p_o_s should	both
  be 4.

RETURN VALUES

  A value that represents the status (success or failure) of the replace
  operation, as	follows:
  _______________________________________________________

  Value			     Description

  _______________________________________________________

  DXmCSTextStatusEditDone    Text replaced successfully.

  DXmCSTextStatusEditError   Text not replaced (failure).

  _______________________________________________________

RELATED	INFORMATION

  DDXXmmCCrreeaatteeCCSSTTeexxtt(3X), DDXXmmCCSSTTeexxttSSeettSSttrriinngg(3X), DDXXmmCCSSTTeexxttGGeettSSttrriinngg(3X)

