XmTextFindString(3X) X11 SDE 5.4R3.00 XmTextFindString(3X)
NAME
XmTextFindString--A Text function that finds the beginning position
of a text string
SYNOPSIS
#include <Xm/Xm.h>
Boolean XmTextFindString (widget, start, string, direction, position)
Widget widget; XmTextPositionstart;
char *string; XmTextDirectiondirection;
XmTextPosition*position;
DESCRIPTION
XmTextFindString locates the beginning position of a specified text
string. This routine searches forward or backward for the first
occurrence of the string starting from the given start position. If
it finds a match, the function returns the position of the first
character of the string in position.
widget Specifies the Text widget ID.
start Specifies the character position from which the search
proceeds. This is an integer number of characters from the
beginning of the text buffer. The first character position
is 0.
string Specifies the search string.
direction
Indicates the search direction. It is relative to the
primary direction of the text. The possible values are
XmTEXT_FORWARD The search proceeds toward the end of the
text buffer.
XmTEXT_BACKWARD The search proceeds toward the beginning of
the text buffer.
position
Specifies the pointer in which the first character position
of the string match is returned. This is an integer number
of characters from the beginning of the buffer. The first
character position is 0. If the function returns False, this
value is undefined.
For a complete definition of Text and its associated resources, see
XmText(3X).
RETURN VALUE
Returns True if a string match is found; otherwise, returns False.
Licensed material--property of copyright holder(s) 1
XmTextFindString(3X) X11 SDE 5.4R3.00 XmTextFindString(3X)
RELATED INFORMATION
XmText(3X) and XmTextFindStringWcs(3X).
Licensed material--property of copyright holder(s) 2