CodePage

Purpose

ProEssentials v6 and later is Unicode, however, this property is 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 CodePage argument within the WideCharToMultiByte Windows API call invoked by ProEssentials. This allows you to control the CodePage used within the conversion of Unicode to MultiByte strings.

For example, if your application is using Chinese characters, you would set CodePage = 950, CharSet = 136, and WideCharToMultiByte = True.

The constants below apply to this property. For more info, see Microsoft's documentation for the WideCharToMultiByte Api call.

Comments

See Also: CharSet, WideCharToMultiByte, RenderEngine

Code Page Identifiers