|
<< Click to Display Table of Contents >> VpeSetCharset |
  
|
|
<< Click to Display Table of Contents >> VpeSetCharset |
|
Sets the charset.
void VpeSetCharset(
VpeHandle hDoc,
long charset
)
VpeHandle hDoc
Document Handle or VPE Object Handle
long charset
character set, possible values are:
Constant Name |
Value |
Comment |
VCHARSET_DEFAULT |
1 |
Windows: Chooses the VCHARSET_WIN_ character set that fits to the localization settings of the current user. |
VCHARSET_SYMBOL |
2 |
Required for using Symbol Fonts, like WingDings |
VCHARSET_MAC_ROMAN |
77 |
Macintosh Roman |
Character sets compatible to the character sets of the Windows operating system: |
||
VCHARSET_WIN_ANSI |
0 |
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 |
Hebrew |
VCHARSET_WIN_ARABIC |
178 |
Arabic |
VCHARSET_WIN_GREEK |
161 |
Greek |
VCHARSET_WIN_TURKISH |
162 |
Turkish |
VCHARSET_WIN_VIETNAMESE |
163 |
Vietnamese |
VCHARSET_WIN_THAI |
222 |
Thai |
VCHARSET_WIN_EAST_EUROPE |
238 |
Albanian, Belarusian, Croatian, Czech, Hungarian, Polish, Romanian, Serbian, Slovak, Slovenian |
VCHARSET_WIN_CYRILLIC |
204 |
Bulgarian, Russian, Serbian and Ukrainian (Cyrillic) |
VCHARSET_WIN_BALTIC |
186 |
Estonian, Latvian and Lithuanian |
Character sets compatible to the ISO character sets (taken from unicode.org): |
||
VCHARSET_ISO_LATIN_1 |
50 |
Latin-1, Western character set (ISO-8859-1) |
VCHARSET_ISO_LATIN_2 |
51 |
Latin-2, East European (ISO-8859-2) |
VCHARSET_ISO_LATIN_3 |
52 |
Latin-3, South European (ISO-8859-3) |
VCHARSET_ISO_LATIN_4 |
53 |
Latin-4, Baltic (ISO-8859-4) |
VCHARSET_ISO_CYRILLIC |
54 |
Cyrillic (ISO-8859-5) |
VCHARSET_ISO_ARABIC |
55 |
Arabic (ISO-8859-6) |
VCHARSET_ISO_GREEK |
56 |
Greek (ISO-8859-7) |
VCHARSET_ISO_HEBREW |
57 |
Hebrew (ISO-8859-8) |
VCHARSET_ISO_LATIN_5 |
58 |
Latin-5, Turkish (ISO-8859-9) |
VCHARSET_ISO_LATIN_6 |
59 |
Latin-6, Nordic (ISO-8859-10) |
VCHARSET_ISO_THAI |
60 |
Thai (ISO-8859-11) |
VCHARSET_ISO_LATIN_7 |
62 |
Latin-7, Baltic (ISO-8859-13) |
VCHARSET_ISO_LATIN_8 |
63 |
Latin-8, Celtic (ISO-8859-14) |
VCHARSET_ISO_LATIN_9 |
64 |
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.
In a future release a UNICODE version of VPE will be created.