Show/Hide Toolbars

EmEditor Help

Navigation: EmEditor Help > Plug-in Reference > Inline Functions

EmEditor Plug-in Reference: Editor_Convert

Scroll Prev Top Next More
EmEditor Home - EmEditor Help - Plug-in Reference - Inline Functions

Editor_Convert

Converts characters. You can use this inline function or explicitly send the EE_CONVERT message.

Editor_Convert( HWND hwnd, UINT nFlags, LPCWSTR szChars = NULL );

Parameters

hwnd

Specifies the window handle of the view or frame of EmEditor.

nFlags

You can specify a combination of the following values.

Value

Meaning

FLAG_MAKE_LOWER

Converts to lowercase characters.

FLAG_MAKE_UPPER

Converts to uppercase characters.

FLAG_HAN_TO_ZEN

Converts to full-size characters.

FLAG_ZEN_TO_HAN

Converts to half-size characters.

FLAG_CAPITALIZE

Capitalizes the first letter of each word.

FLAG_CONVERT_SELECT_ALL

Converts the entire text. If this flag is not set, EE_CONVERT converts the characters only in the selection.

FLAG_CONVERT_KATA

Converts Katakana.

FLAG_CONVERT_ALPHANUMERIC

Converts Alphabets and numeric characters.

FLAG_CONVERT_MARK

Converts marks.

FLAG_CONVERT_SPACE

Converts spaces.

FLAG_CONVERT_KANA_MARK

Converts Kana marks.

FLAG_CONVERT_CUSTOM

When FLAG_HAN_TO_ZEN or FLAG_ZEN_TO_HAN is specified, the szChars parameter specifies which individual characters should be converted. If this value is specified, you must also specify the szChars parameter, and FLAG_CONVERT_KATA, FLAG_CONVERT_ALPHANUMERIC, FLAG_CONVERT_MARK, FLAG_CONVERT_SPACE, FLAG_CONVERT_KANA_MARK values are ignored.

FLAG_JAPANESE_YEN

Converts U+005C (REVERSE SOLIDUS) to U+FFE5 (FULLWIDTH YEN SIGN), and vice versa.

FLAG_KOREAN_WON

Converts U+005C (REVERSE SOLIDUS) to U+FFE6 (FULLWIDTH WON SIGN), and vice versa.

FLAG_RIGHT_SINGLE_QUOTATION

Converts U+0027 (APOSTROPHE) to U+2019 (RIGHT SINGLE QUOTATION MARK), and vice versa.

FLAG_RIGHT_DOUBLE_QUOTATION

Converts U+0022 (QUOTATION MARK) to U+201D (RIGHT DOUBLE QUOTATION MARK), and vice versa.

szChars

You can set a combination of individual full-width characters you want to convert if FLAG_CONVERT_CUSTOM is specified. Set this parameter NULL if not used.

Return Values

If the message succeeds, the return value is nonzero. If the message fails, the return value is zero.

Copyright © 2003-2021 by Emurasoft, Inc.