


XmTextInsert(3X)					     XmTextInsert(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTeexxttIInnsseerrtt - A Text	function that inserts a	character string into 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tIInnsseerrtt((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n, _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 _p_o_s_i_t_i_o_n;;
       cchhaarr	      *	_v_a_l_u_e;;

DESCRIPTION
  XXmmTTeexxttIInnsseerrtt inserts a character string into the text	string in the Text
  widget.  The character positions begin at zero and are numbered sequen-
  tially from the beginning of the text.  For example, to insert a string
  after	the fourth character, the parameter _p_o_s_i_t_i_o_n 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.

  _p_o_s_i_t_i_o_n
	 Specifies the position	in the text string where the character string
	 is to be inserted.

  _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tIInnsseerrttWWccss((33XX)).




















