ImageGear for C and C++ on Windows v19.1 - Updated
IG_REC_languagesplus_set
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Language Settings Functions > IG_REC_languagesplus_set

Used to specify some individual characters, the LanguagesPlus characters. These characters are added to the set of characters determined by the language selection. The resulting set of characters is called the Language environment.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_languagesplus_set(
   LPCWSTR pLanguagesPlus
);

Arguments:

Name Type Description
pLanguagesPlus LPCWSTR Pointer to a UNICODE string containing the LanguagesPlus characters to be set. (The string is terminated with a wide-character zero.)

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
ErrCount += IG_REC_languagesplus_set(L"AaBbCc"); 

Remarks:

  1. This function is useful if a client believes the accented letters validated for a given language are insufficient, or for handling texts containing foreign words.
  2. When characters to be added are contained in the ANSI (1252) Code Page, the easiest way to define the pLanguagesPlus string is with a wide-character-string literal, L"characters". If any needed character falls outside the ANSI (1252) Code Page, you can convert these characters one after each other with the IG_REC_util_codepage_to_unicode utility function, which converts a single character code from the current single-byte Code Page value (IG_REC_output_codepage_set) to its UNICODE representation. For this a simple word array can be used:

    WCHAR aW[3]; aW[0] = 0x00c9; //Cap E acute aW[1] = 0x00e9; //Lowercase E acute aW[2] = 0;
  3. When the application pre-defines the LanguagesPlus characters, the literal string method may be used with ANSI 1252 characters. However, if the application is going to offer the user a way of defining the LanguagesPlus characters, these should be in UNICODE.
  4. An unusual facility of the Language environment is when there is no language selection at all. This means that only the LanguagesPlus characters will be validated. This can be useful, for example with multiple-choice test answers, where only a few letters are valid (e.g., A, B, C, D).