Editor_SplitColumn

分割当前 CSV 文档的指定列。你能直接用该内联函数或明确地发送 EE_SPLIT_COLUMN 消息。

HRESULT Editor_SplitColumn( HWND hwnd, UINT nType, UINT nFlags, int* anColumns, int nNumOfColumns, int nLimit, LPCWSTR pszSeparator, LPCWSTR pszLocale );

参数

hwnd

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

nType

你可以指定下列值之一。

值	含义
COLUMN_SPLIT_TO_COLUMNS	按分隔符拆分指定的列并将其放到右边的列中。
COLUMN_SPLIT_TO_LINES	按分隔符拆分指定的列并将其放到下方的行中。
COLUMN_SPLIT_TO_NONE	不拆分但按分隔符在指定列中排序或删除重复字符串。

nFlags

你可以指定以下值的组合。必须指定 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	按字数对字符串进行排序。

anColumns

指定包含从 0 开始的列的索引的整数数组。

nNumOfColumns

指定在 anColulmns 中指定的列数。

nLimit

指定每个单元格的最大拆分数。

pszSeparator

当拆分列时，指定一个字符串为分隔符。

pszLocale

指定用于排序的区域设置信息。 如果为空，则使用“自定义”对话框中指定的区域设置。

返回值

如果失败，则返回值为负值。

版本

支持 EmEditor Professional 19.9 或之后的版本。