


XmTextSetSource(3X)					  XmTextSetSource(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTeexxttSSeettSSoouurrccee - A Text function that sets the source of the	widget

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tSSeettSSoouurrccee ((_w_i_d_g_e_t,	_s_o_u_r_c_e,	_t_o_p__c_h_a_r_a_c_t_e_r, _c_u_r_s_o_r__p_o_s_i_t_i_o_n))
       WWiiddggeett	 _w_i_d_g_e_t;;
       XXmmTTeexxttSSoouurrccee_s_o_u_r_c_e;;
       XXmmTTeexxttPPoossiittiioonn_t_o_p__c_h_a_r_a_c_t_e_r;;
       XXmmTTeexxttPPoossiittiioonn_c_u_r_s_o_r__p_o_s_i_t_i_o_n;;

DESCRIPTION
  XXmmTTeexxttSSeettSSoouurrccee sets the source of the Text widget.  Text widgets can	share
  sources of text so that editing in one widget	is reflected in	another.
  This function	sets the source	of one widget so that it can share the source
  of another widget.

  Setting a new	text source destroys the old text source if no other Text
  widgets are using that source.  To replace a text source but keep it for
  later	use, create an unmanaged Text widget and set its source	to the text
  source you want to keep.

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

  _s_o_u_r_c_e Specifies the source with which the widget displays text.  This can
	 be a value returned by	the XXmmTTeexxttGGeettSSoouurrccee((33XX))	function.  If no
	 source	is specified, the widget creates a default string source.

  _t_o_p__c_h_a_r_a_c_t_e_r
	 Specifies the position	in the text to display at the top of the
	 widget.  This is an integer number of characters from the beginning
	 of the	text buffer.  The first	character position is 0.

  _c_u_r_s_o_r__p_o_s_i_t_i_o_n
	 Specifies the position	in the text at which the insert	cursor is
	 located.  This	is an integer number of	characters from	the beginning
	 of the	text buffer.  The first	character position is 0.

  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)).













