IN_FindTextMatch

image\bltlrgsq_shg.gif  Editions  image\bltlrgsq_shg.gif  Related Functions  image\bltlrgsq_shg.gif  Example

The IN_FindTextMatch function uses the specified parameters to search for text in text documents and vector images, except text in annotations. The found text is highlighted and, with text documents, the page where it is located is displayed.

Syntax

int IN_FindTextMatch( docwinID, pText, flags, direction )

Parameters

Values

Meaning

IN_DOCWIN docwinID

0 | docwinID

active | specific

CHARPTR pText

pointer text string to search for

"" (empty string) use the text string last searched for

SHORT flags

0 case-insensitive, partial words allowed

IN_FND_MATCH_CASE (1) match the case

IN_FND_WHOLE_WORDS (2) 
find whole words

(can be concatenated or ORed)

SHORT direction

IN_DIR_FIRST (0) first match

IN_DIR_LAST (1) last match

IN_DIR_PREVIOUS (2) previous match

IN_DIR_NEXT (3) next match

Remarks

If the document searched is in Word format, this function will span pages and bring up the page that contains a match on-screen. The found text will be highlighted, unless otherwise specified by the IN_ShowTextMatch function.

If you call this function while a current search is going on, the current search will be terminated and the new search will start.

Release information

Added to Imagenation for Windows in Release 4.00.

As of Release 5.1, also available in Imagenation for UNIX.

See also

Searching for text