Editor_PivotTable

在 CSV 文档中创建数据透视表。你能直接用该内联函数或明确地发送 EE_PIVOT_TABLE 消息。

HRESULT Editor_PivotTable( HWND hwnd, int iRow, int iColumn, int iValue, UINT nFlags, UINT nSortRow, UINT nSortColumn, LPCWSTR pszLocale, LPCWSTR pszTotalRowLabel, LPCWSTR pszTotalColLabel, int nDecimalPlaces );

参数

hwnd

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

iRow

指定 CSV 文档的列的索引，用于扩展到新数据透视表中的行。

iColumn

指定 CSV 文档的列的索引，用于扩展到新数据透视表中的列。

iValue

指定 CSV 文档的列的索引，用于扩展到新数据透视表中的值。

nFlags

指定下列值的组合。

PIVOT_TYPE_COUNT	值的数量。
PIVOT_TYPE_SUM	值的总和。
PIVOT_TYPE_AVERAGE	值的平均值。
PIVOT_TYPE_MAX	最大的值。
PIVOT_TYPE_MIN	最小的值。
PIVOT_FLAG_TOTAL_ROW	显示行的总值。
PIVOT_FLAG_TOTAL_COL	显示列的总值。

nSortRow

指定应用于行的排序标志组合。如果此项为 0，则不会执行排序。

值	含义
NORM_IGNORECASE	忽略大小写。
NORM_IGNOREKANATYPE	平假名和片假名字符比较相等。
NORM_IGNORENONSPACE	忽略非空格字符。
NORM_IGNORESYMBOLS	忽略符号。
NORM_IGNOREWIDTH	忽略半角和全角字符之间的差异。
SORT_BINARY_COMPARISON	使用更快的二进制排序算法进行排序，该算法忽略区域设置信息。
SORT_DATE	对日期和时间进行排序。
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_STABLE	使用稳定排序。稳定排序会维护相同记录的相对顺序，但会比较慢。
SORT_STRINGSORT	标点符号的处理方式与符号相同。
SORT_TEXT	对文本进行排序。
SORT_WORDS	按单词数对字符串进行排序。

nSortColumn

指定包含要应用于列的排序标志的组合。如果此项为 0，则不会执行排序。这些标志与 nSortRow 参数相同。

pszLocale

指定用于排序的语言环境，例如：“en-US”。如果此项为空或省略，则使用在 自定义 对话框的 排序 页面中指定的区域设置。

pszTotalRowLabel

指定行的总值的标题标签。只有在 nFlags 参数中指定 PIVOT_FLAG_TOTAL_ROW 时才使用此参数。

pszTotalColLabel

指定列的总值的标题标签。只有在 nFlags 参数中指定 PIVOT_FLAG_TOTAL_COL 时才使用此参数。

nDecimalPlaces

指定值的小数位数。

返回值

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

版本

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