1XmTextFieldReplace(library call)              XmTextFieldReplace(library call)
2
3
4

NAME

6       XmTextFieldReplace  — A TextField function that replaces part of a text
7       string
8

SYNOPSIS

10       #include <Xm/TextF.h>
11       void XmTextFieldReplace(
12       Widget widget,
13       XmTextPosition from_pos,
14       XmTextPosition to_pos,
15       char * value);
16

DESCRIPTION

18       XmTextFieldReplace replaces part of the text string  in  the  TextField
19       widget.  The  character  positions  begin  at 0 (zero) and are numbered
20       sequentially from the beginning of the text.
21
22       An example text replacement would be to replace the  second  and  third
23       characters  in  the  text  string.  To  accomplish  this, the parameter
24       from_pos must be 1 and to_pos must be 3. To insert a string  after  the
25       fourth character, both parameters, from_pos and to_pos, must be 4.
26
27       This  routine  calls the widget's XmNvalueChangedCallback and verifica‐
28       tion callbacks, either XmNmodifyVerifyCallback or  XmNmodifyVerifyCall‐
29       backWcs,  or  both. If both verification callback lists are registered,
30       the procedures of the XmNmodifyVerifyCallback list are  executed  first
31       and  the  resulting  data  is  passed to the XmNmodifyVerifyCallbackWcs
32       callbacks.  The XmNmotionVerifyCallback is generated if to_pos is  less
33       than or equal to the cursor position and the length of value is not the
34       same as the length of the text being replaced, or if the  cursor  posi‐
35       tion  is  between from_pos and to_pos, and the distance from the cursor
36       position to from_pos is greater than the length of value.
37
38       widget    Specifies the TextField widget ID
39
40       from_pos  Specifies the start position of the text to be replaced
41
42       to_pos    Specifies the end position of the text to be replaced
43
44       value     Specifies the character string value to be added to the  text
45                 widget
46
47       For  a  complete  definition of TextField and its associated resources,
48       see XmTextField(3).
49
51       XmTextField(3).  XmTextFieldReplaceWcs(3).
52
53
54
55                                              XmTextFieldReplace(library call)
Impressum