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 或之後的版本。