ProEssentials v5 and earlier were MBCS and this property was needed to handle multibyte character sets.
ProEssentials v7 is Unicode, however, this property is still needed in certain scenarios which are not inherently Unicode. RenderEngine defaults to PERE_HYBRID, however, RenderEngine set to PERE_GDI (0) represents pure Metafile compatibility. Metafiles can not support Unicode. If working with a character set that is not a single byte character set (or contains special characters) you should set CharSet and CodePage appropriately. Then also set WideCharToMultiByte = True which enables an internal WideCharToMultiByte conversion of Unicode strings when necessary. If never setting RenderEngine = PERE_GDI, you still need to set the above properties if you want to support exporting Metafile images containing multibyte strings. Exported metafiles are built as if RenderEngine is set to PERE_GDI.
This property controls the fdwCharSet argument in all Windows CreateFont API calls invoked by ProEssentials. This allows you to change the character set used for text within ProEssentials controls and images.
The following constants apply to this property. For more info, see Microsoft's documentation for the CreateFont Api call.
For example, if your application is using Chinese characters, you would set CodePage = 950, CharSet = 136, and WideCharToMultiByte = True.
©2013 Gigasoft, Inc. | All rights reserved.
Gigasoft is a registered trademark, and ProEssentials a trademark of Gigasoft, Inc.