Plug-in Reference — Messages — EE_CONVERT

# EE_CONVERT

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

    EE_CONVERT
    wParam = (WPARAM) (UINT) nFlags;
    lParam = (LPARAM) (LPCWSTR) szChars;

## Parameters

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_MAKE_LOWER_L | Converts to lowercase characters (locale-dependent).
FLAG_MAKE_UPPER_L | Converts to uppercase characters (locale-dependent).
FLAG_CAPITALIZE_L | Capitalizes the first letter of each word (locale-dependent).
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.