ixAddWildCardPatternToHighlightMatcher
Name
ixAddWildCardPatternToHighlightMatcher
Synopsis
void ixAddWildCardPatternToHighlightMatcher(HighlightMatcherT HighlightMatcher, UCharT *Pattern, size_t PatternLength, StatusCodeT *Status)
Arguments
HighLightMatcher: A highlighter object returned by ixCreateHighlightMatcher.
Pattern: A string containing the pattern that the highlighter object will match.
PatternLength: The length of the pattern string.
Status: A pointer to a value of type StatusCodeT representing any error conditions.
Returns
Nothing.
If an error occurred, Status will be set to the error number.
Description
You must add a pattern to the list of patterns matched by the highlight object with ixAddWildCardPatternToHighLightMatcher. You match patterns with the function ixHighlightMatcherMatch. You pass it a word and it will tell you if you ought to match it.
These functions are primarily provided to make it easy to highlight words in a document you display. You might wish to highlight in yellow the words that that user was searching for. Since users can search not only for words but also patterns using wildcards these functions will let you match anything that the user can search for. They are provided so that you don't have to write your own wildcard matching routines.
When you are finished with the highlight object you must delete it with a call to ixDeleteHighlightMatcher.
See Also
Highlighting
ixCreateHighlightMatcher, ixDeleteHighlightMatcher, ixHighlightMatcherMatch