Charset (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Changing the character set

Font variable

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:

Find out the character set currently used by a Font variable.
Modify the character set used by a Font variable.

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

Reminder: By default, the character set used by a data file is the ANSI character set. To modify the character set used by a data file, you must:

Use ChangeCharset to specify the character set that must be taken into account.
Create the data file while taking the change of character set into account (HCreation or HCreationIfNotFound).

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

New in version 18

This property is now available in Windows Store Apps mode.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 21 and later

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

New in version 21

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

Example

// Example with a Font variable
// Define the font characteristics
Font1 is Font
Font1.Name = "Arial"
Font1.Size = 14
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 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

Finding out the character set currently 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 defined for the current 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 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 use.

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

<Font>.Charset = <New charset>

<Font>: Font variable

Name of the Font variable to use.

<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 defined for the current 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 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

Finding out the character set currently 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 Current character set specified with ChangeCharset
charsetDefault Default character set defined for the current 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 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 (with or without quotes)

Logical name of the HFSQL data file to use.

Remarks

Changing the character set

When changing the character set, the fonts that use the requested 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:

FontCreate,
Angle, StrikeOut, Condensed, Color, Extended, Bold, Italic, Large, Name, Underline and Size properties.

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 of controls in a window).
In the controls of a report (Font property of controls in a report).