CharSet

<< Click to Display Table of Contents >>

Navigation:  Text Functions >

CharSet

Previous pageReturn to chapter overviewNext page

Sets the charset.

property CharSet [long] VPE.CharSet

read / write; runtime only; also supported by TVPEObject

Possible Values:

character set, possible values are:

ActiveX / VCL

Value

Enum

Comment

VCHARSET_DEFAULT

1

Default

Windows: Chooses the VCHARSET_WIN_ character set that fits to the localization settings of the current user.
All other platforms: sets the charset to ISO_LATIN_1

VCHARSET_SYMBOL

2

Symbol

Required for using Symbol Fonts, like WingDings

VCHARSET_MAC_ROMAN

77

MacRoman

Macintosh Roman

 

Character sets compatible to the character sets of the Windows operating system:

VCHARSET_WIN_ANSI

0

WinAnsi

Western character set: Afrikaans, Basque, Catalan, Danish, Dutch, English, Esperanto, Faroese, Finnish, French, Frisian, Galician, German, Icelandic, Indonesian, Interlingua, Irish, Italian, Latin, Malay, Maltese, Norwegian, Pilipino, Portuguese, Spanish, Swahili, Swedish, Welsh

VCHARSET_WIN_HEBREW

177

WinHebrew

Hebrew

VCHARSET_WIN_ARABIC

178

WinArabic

Arabic

VCHARSET_WIN_GREEK

161

WinGreek

Greek

VCHARSET_WIN_TURKISH

162

WinTurkish

Turkish

VCHARSET_WIN_VIETNAMESE

163

WinVietnamese

Vietnamese

VCHARSET_WIN_THAI

222

WinThai

Thai

VCHARSET_WIN_EAST_EUROPE

238

WinEastEurope

Albanian, Belarusian, Croatian, Czech, Hungarian, Polish, Romanian, Serbian, Slovak, Slovenian

VCHARSET_WIN_CYRILLIC

204

WinCyrillic

Bulgarian, Russian, Serbian and Ukrainian (Cyrillic)

VCHARSET_WIN_BALTIC

186

WinBaltic

Estonian, Latvian and Lithuanian

 

Character sets compatible to the ISO character sets (taken from unicode.org):

VCHARSET_ISO_LATIN_1

50

IsoLatin1

Latin-1, Western (ISO-8859-1)

VCHARSET_ISO_LATIN_2

51

IsoLatin2

Latin-2, East European (ISO-8859-2)

VCHARSET_ISO_LATIN_3

52

IsoLatin3

Latin-3, South European (ISO-8859-3)

VCHARSET_ISO_LATIN_4

53

IsoLatin4

Latin-4, Baltic (ISO-8859-4)

VCHARSET_ISO_CYRILLIC

54

IsoCyrillic

Cyrillic (ISO-8859-5)

VCHARSET_ISO_ARABIC

55

IsoArabic

Arabic (ISO-8859-6)

VCHARSET_ISO_GREEK

56

IsoGreek

Greek (ISO-8859-7)

VCHARSET_ISO_HEBREW

57

IsoHebrew

Hebrew (ISO-8859-8)

VCHARSET_ISO_LATIN_5

58

IsoLatin5

Latin-5, Turkish (ISO-8859-9)

VCHARSET_ISO_LATIN_6

59

IsoLatin6

Latin-6, Nordic (ISO-8859-10)

VCHARSET_ISO_THAI

60

isoThai

Thai (ISO-8859-11)

VCHARSET_ISO_LATIN_7

62

IsoLatin7

Latin-7, Baltic (ISO-8859-13)

VCHARSET_ISO_LATIN_8

63

IsoLatin8

Latin-8, Celtic (ISO-8859-14)

VCHARSET_ISO_LATIN_9

64

IsoLatin9

Latin-9, Western (ISO-8859-15)

 

Default:

DEFAULT_CHARSET

Remarks:

The Mac and Iso charsets are intended for Non-Windows platforms. They should not be used with .NET, they will not function under .NET. They can be used on Windows with the ActiveX or DLL, but in this case only for PDF file creation, the preview will display wrong characters.

 

The supported character sets for the Base 14 fonts are limited to WinAnsi, WinEastEurope, WinTurkish, WinBaltic, IsoLatin1, IsoLatin2, IsoLatin5, IsoLatin7, IsoLatin9. MacRoman is nearly fully supported, but the following characters are missing:
unicode 221e (ansi code 176) INFINITY
unicode 220f (ansi code 184) GREEK CAPITAL LETTER PI
unicode 03c0 (ansi code 185) GREEK SMALL LETTER PI
unicode 222b (ansi code 186) INTEGRAL
unicode 03a9 (ansi code 189) GREEK CAPITAL LETTER OMEGA
unicode 2248 (ansi code 197) ALMOST EQUAL TO (asymptotic to)
unicode f8ff (ansi code 240) Apple Logo.

For other character sets, True-Type fonts are required.

 

When exporting to PDF, some characters are missing in the WIN_ARABIC and ISO_GREEK codepages. This is due to the technique, VPE uses to define character sets within PDF documents – and that Adobe did not define those characters in their Glyphlist.

A future version of VPE will overcome this problem.

 

The following characters of the charset WIN_ARABIC are missing:

Unicode U+06A9, Code 152, Arabic Letter "Keheh"

Unicode U+06BE, Code 170, Arabic Letter " Heh Doachashmee"

Both characters are for Persian and Urdu scripts only. So outputting arabic text is not affected.

NOTE: the ISO_ARABIC codepage is fully supported.

 

The following character of the charset ISO_GREEK is missing:

Unicode U+20AF, Code 165, Drachma Sign

NOTE: the WIN_GREEK codepage is fully supported.

 

To display characters from a symbol font, it is required to set the Charset to VCHARSET_ SYMBOL. VPE switches automatically the Charset to Symbol, if a Symbol font is selected. Vice versa, VPE switches back to the previously used Charset, if a non-Symbol font is selected.

 

To use a specific charset, it might be required to use a font which supports this charset. For example, if you use the font Arial with the THAI charset, this font is not available on western versions of Windows by default.

 

VPE does not support double-byte character sets, nor does it support UNICODE.

RTL reading (right-to-left) is not supported.