ChangeCharset (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

How to use a specific character set?

Changing the character set used by the fonts

Changing the character set used by the operations performed on the character strings

Changing the character set control by control

Using the charsetUTF8 constant

See also

ChangeCharset (Function)

In french: ChangeAlphabet

Retrieves and/or changes the character set used:

by all the screen fonts.
by all the operations performed on the character strings (functions and/or operators).

This function allows you to manage all the languages that use specific character sets. The change of character set will be taken into account during the next opening of a window or page. We advise you to close and to re-open all the windows or pages.

Note: The different fonts are available in different character sets. For example, the "Arial" font exists in the western character set as well as in the Greek or Hebrew character set.

Versions 17 and later

This function is now available for Java applications.

New in version 17

This function is now available for Java applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

See additional examples

// Change the display language of application to Chinese
// Sub-language : Macau (5)
// Sort mode: bopomofo standard (3)
Nation(nationChinese)
// Modify the character set
ChangeCharset(charsetChinese, languageChinese, 5, 3)
// Redisplay the "WIN_Window1" window
Use(WIN_Window1)

Syntax

Modifying the character set to use Hide the details

<Result> = ChangeCharset(<New Charset> [, <Language> [, <Sub-language> [, <Sort mode>]]])

<Result>: Integer constant

Constant identifying the character set used before the modification.

<New Charset>: Integer constant

Constant corresponding to the new character set to use:
charsetAnsi Roman characters in ANSI standard
charsetArabic Arabic characters
charsetBaltic Baltic characters
charsetChinese Chinese characters (People's Republic of China)
charsetTraditionalChinese Traditional Chinese characters (Republic of Taiwan)
charsetKorean Korean characters
charsetDefault Uses the default character set defined for the computer. No character set is forced.
charsetEastEurope Characters of Eastern Europe (Polish, ...)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
Versions 20 and later
charsetMac
New in version 20
charsetMac
charsetMac Characters to the Mac Roman standard (used on the old Macintosh versions).
charsetOccidental Roman characters in ANSI standard
charsetUTF8 Used to manage the countries with two character sets (Hong Kong) and the countries with no character set defined in Windows (Georgian and Armenian).
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters
charsetVietnamese Vietnamese characters

<Language>: Optional Integer constant

New language to use. See Correspondence between languages, sub-languages, character sets and nations for more details.
This language must correspond to the specified <New Charset>. Otherwise, a WLanguage error will occur.
This parameter is used to manage the specific features of each country.

<Sub-language>: Optional integer

New sub-language to use. See Correspondence between languages, sub-languages, character sets and nations for more details.
This sub-language must correspond to the specified <New Charset>. Otherwise, a WLanguage error will occur.
This parameter is used to manage the specific features of each country.
Versions 17 and later
This parameter is ignored.
New in version 17
This parameter is ignored.
This parameter is ignored.

<Sort mode>: Optional integer

New sort mode to use. Only the following sort modes are available. This parameter is not available for the other languages.
Language Sort mode
Constant Value Sort Value
languageGerman 7 Standard 0
Directory 1
languageChinese 4 Phonetic 0
Unicode 1
Stroke count order 2
Bopomofo standard 3
languageKorean 18 KSC 0
Unicode 1
languageGeorgian 55 Standard 0
Modern 1
languageHungarian 14 Standard 0
Technical 1
languageJapanese 17 XJIS 0
Unicode 1
Versions 17 and later
This parameter is ignored.
New in version 17
This parameter is ignored.
This parameter is ignored.

Retrieving the character set currently used Hide the details

<Result> = ChangeCharset()

<Result>: Integer constant

Constant identifying the character set currently used.
charsetAnsi Roman characters in ANSI standard
charsetArabic Arabic characters
charsetBaltic Baltic characters
charsetChinese Chinese characters (People's Republic of China)
charsetTraditionalChinese Traditional Chinese characters (Republic of Taiwan)
charsetKorean Korean characters
charsetDefault Uses the default character set defined for the computer. No character set is forced.
charsetEastEurope Characters of Eastern Europe (Polish, ...)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
Versions 20 and later
charsetMac
New in version 20
charsetMac
charsetMac Characters to the Mac Roman standard (used on the old Macintosh versions).
charsetOccidental Roman characters in ANSI standard
charsetUTF8 Used to manage the countries with two character sets (Hong Kong) and the countries with no character set defined in Windows (Georgian and Armenian).
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters

Remarks

How to use a specific character set?

To use a specific character set, you must:

Install the files corresponding to the requested character sets in the regional settings of Windows (control panel).
Use ChangeCharset in your program.

Changing the character set used by the fonts

ChangeCharset modifies the character set used by all fonts. The fonts that use the requested character set must be installed on the current computer.

ChangeCharset takes effect immediately. We advise you to close and re-open all the windows or pages.

To apply this change to the current window, we recommend that you use Use to force the re-opening of current window.

See Managing specific character sets in an application for more details.

Changing the character set used by the operations performed on the character strings

ChangeCharset modifies the character set used by the operations performed on the character strings. This new character set will be taken into account:

when comparing two strings according to the lexicographical order (StringCompare associated with the ccLexicographicOrder constant). This comparison does not take the "double letters" into account (CH in Spanish or LJ in Croatian for example).
in the HFSQL indexes (Classic mode or Client/Server mode) once the indexes have been built or rebuilt (HCreation, HCreationIfNotFound or HIndex associated with the hChangeCharset constant). The sort order in the indexes does not take the "double letters" into account (CH in Spanish or LJ in Croatian for example).

ChangeCharset takes effect immediately. We advise you to close and re-open all the windows or pages.

To apply this change to the current window, we recommend that you use Use to force the re-opening of current window.

See Managing specific character sets in HFSQL data files for more details.

Changing the character set control by control

You also have the ability to modify the character set used control by control with ..FontCharset.

Using the charsetUTF8 constant

The charsetUTF8 constant is used to manage the countries with two character sets (Hong Kong) and the countries with no character set defined in Windows.

In this mode, if a Latin character set is used, the accented characters are not coded on one byte but on several bytes. A character can be coded on 4 bytes.
This operating mode triggers specific effects when managing the character strings.
For example, Length does no longer return the number of characters but the number of bytes corresponding to the string. We recommend that you use UnicodeToAnsi before performing specific operations on the character strings.

Component : wd250vm.dll