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

FreeBSD Manual Pages


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

       XmTextInsert  --	A Text function	that inserts a character string	into a
       text string

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

       XmTextInsert inserts a character	string into the	 text  string  in  the
       Text widget. The	character positions begin at 0 (zero) and are numbered
       sequentially from the beginning of the text. For	example, to  insert  a
       string after the	fourth character, the parameter	position 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.  If the XmNcursorPosition resource is	greater	than or	is the
       same value as position, the XmNmotionVerifyCallback is called.

       Note  that,  if value is	a null string, no callbacks will be generated,
       since no	modifications will have	been made.

       widget	 Specifies the Text widget ID.

       position	 Specifies the position	in the text string where the character
		 string	is to be inserted.

       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 XmTextInsertWcs(3).



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

home | help