DtEditorFind(library call) DtEditorFind(library call)
NAME [Toc] [Back]
DtEditorFind - search for the next occurrence of a string in a
DtEditor widget
SYNOPSIS [Toc] [Back]
#include <Dt/Editor.h>
Boolean DtEditorFind(
Widget widget,
char *find);
DESCRIPTION [Toc] [Back]
The DtEditorFind function searches for the next occurrence (relative
to the insertion cursor) of a string. The string is either the last
find string value specified in the Find/Change dialog (see
DtEditorInvokeFindChangeDialog(3)) or is passed in as an argument.
The widget argument specifies the DtEditor widget ID.
The find argument specifies the string to search for. If find is
NULL, DtEditorFind uses the last string specified in the Find field of
the Find/Change dialog. If the string is not found by the time the
end of the document is reached, the search continues at the beginning
of the document, stopping at the character before the insertion
cursor.
For a complete definition of the DtEditor widget and its associated
resources, see DtEditor(3).
RETURN VALUE [Toc] [Back]
Upon successful completion, the DtEditorFind function returns True if
the search string was found; otherwise, it returns False.
SEE ALSO [Toc] [Back]
Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorChange(3),
DtEditorInvokeFindChangeDialog(3).
- 1 - Formatted: January 24, 2005 [ Back ] |