Editor_Convert¶

转换字符。你能直接用该内联函数或明确地发送 EE_CONVERT 或 EE_CONVERT_EX 消息。

Editor_Convert( HWND hwnd, UINT nFlags, LPCWSTR szChars = NULL, LPCWSTR pszSeparator = NULL, UINT nSortFlags = 0, LPCWSTR pszLocale = NULL );

参数¶

hwnd

指定 EmEditor 视图或框架的窗口句柄。

nFlags

你能指定一个下列值的组合。

值	含义
FLAG_MAKE_LOWER	转换为小写字符。
FLAG_MAKE_UPPER	转换为大写字符。
FLAG_HAN_TO_ZEN	转换为全角字符。
FLAG_ZEN_TO_HAN	转换为半角字符。
FLAG_CAPITALIZE	大写每一个单词的第一个字母。
FLAG_MAKE_LOWER_L	转换为小写字符（与区域设置相关）。
FLAG_MAKE_UPPER_L	转换为大写字符（与区域设置相关）。
FLAG_CAPITALIZE_L	将每个单词的首字母大写（与区域设置相关）。
FLAG_CONVERT_SELECT_ALL	转换整个文本。如果没有设置该标志，EE_CONVERT 只会转换选取部分的字符。
FLAG_CONVERT_KATA	转换片假名。
FLAG_CONVERT_ALPHANUMERIC	转换字母和数字字符。
FLAG_CONVERT_MARK	转换标记。
FLAG_CONVERT_SPACE	转换空格。
FLAG_CONVERT_KANA_MARK	转换假名标记。
FLAG_CONVERT_CUSTOM	当指定 FLAG_HAN_TO_ZEN 或 FLAG_ZEN_TO_HAN 时，szChars 参数指定应转换哪些单个字符。如果指定了此值，则还必须指定 szChars 参数，并忽略 FLAG_CONVERT_KATA，FLAG_CONVERT_ALPHANUMERIC，FLAG_CONVERT_MARK，FLAG_CONVERT_SPACE，FLAG_CONVERT_KANA_MARK 的值。
FLAG_JAPANESE_YEN	将 U+005C（反斜线号）转换为 U+FFE5（全角日元标记），反之亦然。
FLAG_KOREAN_WON	将 U+005C（反斜线号）转换为 U+FFE6（全角韩元标记），反之亦然。
FLAG_RIGHT_SINGLE_QUOTATION	将 U+0027（撇号）转换为 U+2019（右单引号），反之亦然。
FLAG_RIGHT_DOUBLE_QUOTATION	将 U+0022（引号）转换为 U+201D（右双引号），反之亦然。

szChars

如果指定了 FLAG_CONVERT_CUSTOM，则可以设置要转换的单个全角字符的组合。如果不使用，请将此参数设置为 NULL。

pszSeparator

指定一个字符串作为拆分列时的分隔符。

nSortFlags

你可以指定以下值的组合。必须指定 SORT_ENABLED 以对拆分字符串进行排序，可以与其他标志合用来指定排序行为。必须指定 SORT_DELETE_DUPLICATE 以删除重复的拆分字符串。

值	含义
NORM_IGNORECASE	忽略大小写。
NORM_IGNOREKANATYPE	平假名和片假名字符相等。
NORM_IGNORENONSPACE	忽略非空格字符。
NORM_IGNORESYMBOLS	忽略符号。
NORM_IGNOREWIDTH	忽略半角和全角字符之间的差别。
SORT_BINARY_COMPARISON	用快速二进制比较来排序。将忽略区域设置信息。
SORT_DATE	对日期和时间进行排序。
SORT_DELETE_DUPLICATE	删除重复的拆分字符串。
SORT_DIGITSASNUMBERS	即使按字母顺序排序，数字也会作为序号被排序。
SORT_ENABLED	排序拆分字符串。
SORT_IGNORE_PREFIX	当用数字升序或数字降序命令时，排序时前导非数字字符会被忽略。
SORT_IPV4	对 IPv4 地址进行排序。
SORT_IPV6	对 IPv6 地址进行排序。
SORT_LENGTH	按字符数对字符串排序。
SORT_LENGTH_VIEW	当选择按文本长度排序命令时，全角字符会被视为 2 个字符。
SORT_NUM	对数字进行排序。
SORT_GROUP_IDENTICAL	按出现次数对相同的字符串进行群组。必须与 SORT_OCCURRENCE 一起指定。
SORT_OCCURRENCE	按出现次数排序。
SORT_RANDOM	随机排序。
SORT_REVERSE	反向排序。
SORT_STABLE	使用平稳排序。平稳排序维护记录的相对顺序，但通常较慢。
SORT_STRINGSORT	把标点符号视为符号。
SORT_TEXT	对文本进行排序。
SORT_WORDS	按字数对字符串排序。
SPLIT_DONT_DISCARD_EXTRA	当 nLimit 不为 0 时，不丢弃多余的拆分字符串。

pszLocale

指定排序的区域设置信息。如果该值为空，将使用在自定义对话框中“排序”选项卡上指定的区域设置。

如果消息成功，返回值为非零值。如果该消息不成功，返回值为零。

支持 EmEditor Professional v22.1 或之后的版本。