Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmTextReplace(3)	   Library Functions Manual	      XmTextReplace(3)

       XmTextReplace --	A Text function	that replaces part of a	text string

       #include	<Xm/Text.h>
       void XmTextReplace(
       Widget widget,
       XmTextPosition from_pos,
       XmTextPosition to_pos,
       char * value);

       XmTextReplace  replaces part of the text	string in the Text widget. The
       character positions begin at 0 (zero)  and  are	numbered  sequentially
       from the	beginning of the text.

       An  example  text  replacement would be to replace the second and third
       characters in the  text	string.	 To  accomplish	 this,	the  parameter
       from_pos	 must  be 1 and	to_pos must be 3. To insert a string after the
       fourth character, both parameters, from_pos and to_pos, must be 4.

       This routine calls the widget's XmNvalueChangedCallback	and  verifica-
       tion  callbacks,	either XmNmodifyVerifyCallback or XmNmodifyVerifyCall-
       backWcs,	or both. If both verification callback lists  are  registered,
       the  procedures	of the XmNmodifyVerifyCallback list are	executed first
       and the resulting data  is  passed  to  the  XmNmodifyVerifyCallbackWcs
       callbacks.   The	XmNmotionVerifyCallback	is generated if	to_pos is less
       than or equal to	the cursor position and	the length of value is not the
       same  as	 the length of the text	being replaced,	or if the cursor posi-
       tion is between from_pos	and to_pos, and	the distance from  the	cursor
       position	to from_pos is greater than the	length of value.

       widget	 Specifies the Text widget ID

       from_pos	 Specifies the start position of the text to be	replaced

       to_pos	 Specifies the end position of the text	to be replaced

       value	 Specifies  the	character string value to be added to the text

       For a complete definition of Text and its associated resources, see Xm-

       XmText(3) and XmTextReplaceWcs(3).



Want to link to this manual page? Use this URL:

home | help