Specifies a set of individual characters, the FilterPlus characters.

Declaration:

AT_ERRCOUNT ACCUAPI IG_REC_filterplus_set(
   LPCWSTR pFilterPlus
);

Arguments:

Return Value:

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The FilterPlus characters broaden or define the filtered set of characters globally or on a per-zone basis. To validate these FilterPlus characters, the zone's filter field should have the IG_REC_FILTER_PLUS value enabled, with or without other filter elements.

1. When characters to be added are contained in the ANSI (1252) Code Page, they can be defined in the pFilterPlus string with a wide-character-string literal, L"characters". Characters outside the ANSI (1252) Code Page can be converted one after the other with the IG_REC_util_codepage_to_unicode() utility. This converts a single character code from the current single-byte Code Page value (IG_REC_output_codepage_set()) to its UNICODE representation.
2. To broaden the Character Set by the defined characters, the filter value needed in the zone structure is:
   
   IG_REC_FILTER_ALL | IG_REC_FILTER_PLUS.
   
3. To add characters to a filtered language environment, IG_REC_FILTER_PLUS should be binary ORed with the other filter values. The FilterPlus characters are added after the effect of the other filter elements. For example, to validate only letters and digits and the filter plus characters (with the punctuation and miscellaneous character categories disabled), the needed value is:
   
   IG_REC_FILTER_ALPHA | IG_REC_FILTER_DIGIT | IG_REC_FILTER_PLUS
4. To validate only the FilterPlus characters, IG_REC_FILTER_PLUS must be the only filter element in the zone structure field. This disables even the letters validated by the language selection.

Example:

AT_ERRCOUNT ErrCount = 0;
enumIGRecChrFilter eFilter = {IG_REC_FILTER_ALPHA | IG_REC_FILTER_DIGIT | IG_REC_FILTER_PLUS};
ErrCount += IG_REC_default_filter_set(eFilter);
ErrCount += IG_REC_filterplus_set(L"-|+=");