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

FreeBSD Manual Pages


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

       XmTextFieldReplace -- A TextField function that replaces	part of	a text

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

       XmTextFieldReplace replaces part	of the text string  in	the  TextField
       widget.	The character positions	begin at 0 (zero) and are numbered se-
       quentially 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 TextField 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 TextField and its associated resources,
       see XmTextField(3).

       XmTextField(3).	XmTextFieldReplaceWcs(3).



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

home | help