CONVERT_INFO

Used by EE_CONVERT_EX message.

typedef struct _CONVERT_INFO {
	UINT cbSize;
	UINT nFlags;
	LPCWSTR pszCustomChars;
	LPCWSTR pszSeparator;
	LPCWSTR pszLocale;
	UINT nSortFlags;
} CONVERT_INFO;

Fields

cbSize

Specifies sizeof( CONVERT_INFO ).

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.

pszCustomChars

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.

pszSeparator

Specifies a string as a separator when splitting a string.

pszLocale

Specifies the locale used to sort. If this is empty, the locale specified in the Customize dialog box is used.

nSortFlags

You can specify a combination of the following values. SORT_ENABLED must be specified to sort split strings, and combine with other flags to specify the sort behavior. SORT_DELETE_DUPLICATE must be specified to remove duplicate split strings.

Value	Meaning
NORM_IGNORECASE	Case is ignored.
NORM_IGNOREKANATYPE	Hiragana and Katakana characters compare as equal.
NORM_IGNORENONSPACE	Nonspacing characters are ignored.
NORM_IGNORESYMBOLS	Symbols are ignored.
NORM_IGNOREWIDTH	The difference between half-width and full-width characters is ignored.
SORT_BINARY_COMPARISON	Fast binary comparison is used to sort. The locale information is ignored.
SORT_DATE	Sorts date and time.
SORT_DELETE_DUPLICATE	Removes duplicate split strings.
SORT_DIGITSASNUMBERS	Digits are sorted as numbers even when sorted by alphabetical order.
SORT_ENABLED	Sorts split strings.
SORT_IGNORE_PREFIX	Leading non-numeric characters are ignored when using Sort Smallest to Largest or Sort Largest to Smallest commands.
SORT_IPV4	Sorts IPv4 addresses.
SORT_IPV6	Sorts IPv6 addresses.
SORT_LENGTH	Sorts strings by the number of characters.
SORT_LENGTH_VIEW	Full width characters are treated as 2 characters when using Sort Shortest to Longest or Sort Longest to Shortest commands.
SORT_NUM	Sorts numbers.
SORT_GROUP_IDENTICAL	Groups identical strings when sorted by occurrence. Must be specified with SORT_OCCURRENCE.
SORT_OCCURRENCE	Sorts by occurrence.
SORT_RANDOM	Sorts randomly.
SORT_REVERSE	Sorts in reverse order.
SORT_STABLE	Stable sort is used. The stable sort maintains the relative order of records. The stable sort is usually slower.
SORT_STRINGSORT	Punctuation marks are treated the same as symbols.
SORT_TEXT	Sorts text.
SORT_WORDS	Sorts strings by the number of words.

Version

Supported on Version 22.1 or later.