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

FreeBSD Manual Pages

  
 
  

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

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

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

DESCRIPTION
     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 char-
     acters 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  verification
     callbacks, either XmNmodifyVerifyCallback or XmNmodifyVerifyCallbackWcs, 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  XmNmotionVeri-
     fyCallback is generated if to_pos is less than or equal to the cursor posi-
     tion  and the length of value is not the same as the length of the text be-
     ing replaced, or if the cursor position 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 wid-
	       get

     For  a  complete  definition  of Text and its associated resources, see Xm-
     Text(3).

RELATED
     XmText(3) and XmTextReplaceWcs(3).

								XmTextReplace(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmTextReplace&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help