WideCharToMultiByte

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.

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

Comments

For more info, see Microsoft's documentation for the WideCharToMultiByte Api call.

See Also: CodePage, CharSet, RenderEngine