Charset (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / HFSQL properties

Changing the character set
Font variable

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Charset (Property)

In french: Alphabet

Available only with these kinds of connection

Use with a Font variable
The Charset property is used to:

Get the character set used by a variable of type Font.
Change the character set used by a variable of type Font.

This property is not available for the Font type.

Use with HFSQL data files
The Charset property gets the character set used by an HFSQL data file. This character set is selected with ChangeCharset and taken into account when creating the data file. This property is read-only.

Reminder: By default, data files use the ANSI character set. To change the character set of a data file, you must:

Use ChangeCharset to specify the character set that must be taken into account.
Create the data file and specify the desired character set (with HCreation or HCreationIfNotFound).

Example

// Example with a Font variable
// Define the font characteristics
Font1 is Font
Font1.Name = "Arial"
Font1.Size = 14
Font1.SizeUnit = unitPoint
Font1.Orientation = 45
Font1.Charset = charsetRussian
// Apply the font to "MyControl"
MyControl.Font = Font1

// Example with the HFSQL data files
HOpen(Customer)
FileLanguage is int = Customer.Charset
// Changes the character set according to the data file format
SWITCH FileLanguage
	CASE charsetArabic: ChangeCharset(charsetArabic)
	CASE charsetDefault: ChangeCharset(charsetDefault)
	CASE charsetGreek: ChangeCharset(charsetGreek)
	CASE charsetHebrew: ChangeCharset(charsetHebrew)
	CASE charsetOccidental: ChangeCharset(charsetOccidental)
	CASE charsetRussian: ChangeCharset(charsetRussian)
	CASE charsetTurkish: ChangeCharset(charsetTurkish)
	OTHER CASE
		// Switch to western character set
		ChangeCharset(charsetOccidental)
END

Syntax

Not available

Getting the character set used by a Font variable Hide the details

<Result> = <Font>.Charset

<Result>: Integer constant

Type of character set used by the specified control:
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
charsetCurrent Uses the current character set specified with ChangeCharset
charsetDefault Default character set of the current computer. No character set is forced.
charsetEastEurope Eastern European character sets (Polish, etc.)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetOccidental Roman characters in ANSI standard
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters
charsetVietnamese Vietnamese characters

<Font>: Font variable

Name of the Font variable to be used.

Not available

Changing the character set used by a Font variable Hide the details

<Font>.Charset = <New charset>

<Font>: Font variable

Name of the Font variable to be used.

<New charset>: Integer constant

Type of character set that will be used in the specified control:
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
charsetCurrent Uses the current character set specified with ChangeCharset
charsetDefault Default character set of the current computer. No character set is forced.
charsetEastEurope Eastern European character sets (Polish, etc.)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetOccidental Roman characters in ANSI standard
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters
charsetVietnamese Vietnamese characters

Getting the character set used by an HFSQL data file Hide the details

<Data file charset> = <Data file>.Charset

<Data file charset>: Integer constant

Type of character set used by the specified data file:
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
charsetCurrent Uses the current character set specified with ChangeCharset
charsetDefault Default character set of the current computer. No character set is forced.
charsetEastEurope Eastern European character sets (Polish, etc.)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetOccidental Roman characters in ANSI standard
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters
charsetVietnamese Vietnamese characters

<Data file>: Character string

Logical name of the HFSQL data file to use.

Remarks

Changing the character set

When changing the character set, the fonts that use the new character set must be installed on the current computer.

Remark: To change the character set for all fonts in a single operation, use ChangeCharset.

Font variable

A font can be created from a Font variable.

To define the font characteristics, use:

the FontCreate function.
the Charset, Orientation, StrikeOut, Color, Bold, Italic, CharacterSpacing, LineSpacing, Name, Underline, Size and SizeUnit properties.
Only the following properties can be used with the Font type: Orientation, StrikeOut, Color, Bold, Italic, Name, Underline, Size.

This font can be used:

To write text in drawings (dFont).
To write in charts (grLabelFont, grLegendFont, grTitleFont and grAxisTitleFont).
To print (iFont).
In the controls of a window (Font property).
In the controls of a report (Font property).