SplitColumn 方法 (Document 對象)¶

用指定的分隔符分割欄，並在 CSV 模式下將其放入右邊的欄或下方的行中。

¶

document.SplitColumn( strColumns, strSeparator, nType, strSortType, nFlags, nLimit, strLocale );

document.SplitColumn strColumns, strSeparator, nType, strSortType, nFlags, nLimit, strLocale

strColumns

指定一個字串，該字串包含用逗號分隔的，從 1 開始的索引的欄。例如，"1,3,5" 表示欄 1，3，和 5。指定的欄會被分割。

指定要分割的最後一欄。

strSeparator

在分割欄時，將一個字串指定為分隔符。此參數不能為空。

nType

您可以指定以下值之一。如果省略，則預設使用 eeSplitIntoColumns。


eeSplitIntoColumns	按分隔符號分割從 iColumn1 到 iColumn2 的欄並將其放到右邊的欄中。
eeSplitIntoLines	按分隔符號分割從 iColumn1 到 iColumn2 的欄並將其放到下方的行中。
eeSplitIntoNone	不分割但按分隔符號在從 iColumn1 到 iColumn2 的欄中排序或刪除重複字串。

strSortType

指定包含標志的字串。如果為空或省略，則分割後將不執行任何排序。

語法：

option (+/-)

option：從下表中選擇一種排序選項：

(+/-)：從下表中選擇一種排序選項：


+	升序。
-	降序。

例如：


A+	按升序對文字進行排序。
N-	按降序對數字進行排序。

nFlags

你可以指定以下值的組合。要刪除重複的分割字串，必須指定eeRemoveDuplicates。僅當 strSortType 不為空時，才能指定其他標志。此參數可以省略。


eeDontDiscardExtra	當 nLimit 不為 0 時，不丟棄多余的分割字串。
eeRemoveDuplicates	刪除重複的分割字串。
eeSortBinaryComparison	用忽略地區設定資訊的快速二進位排序算法進行排序。
eeSortDigitsAsNumbers	即使按字母順序排序，數字也會按數字大小進行排序。開頭負號和開頭小數點不屬於數字。
eeSortGroupIdentical	按出現次數對相同的字串進行群組。
eeSortIgnoreCase	忽略大小寫。
eeSortIgnoreKanaType	平假名和片假名字元作為相同比較。
eeSortIgnoreNonSpace	忽略非空格字元。
eeSortIgnoreSymbols	忽略符號。
eeSortIgnoreWidth	忽略半形和全形字元之間的差異。
eeSortIgnorePrefix	按數字排序時，忽略開頭的非數字字元。
eeSortLengthView	按長度排序時，全形字元被視為 2 個字元。
eeSortStable	使用平穩排序來維護相同記錄的相對順序。穩定排序的速度會較慢。
eeSortStringSort	連字號和所有格符號被視為普通字元。

nLimit

指定每個儲存格的最大分割次數。如果省略或指定 0，則此方法將不限制分割次數。

strLocale

指定排序的地區設定資訊，例如："en-US"。如果該值為空或被省略，將使用在自訂對話方塊中「排序」頁面上指定的地區設定資訊。

下面的範例將欄 1 用分號分割，並將其放入下面的行中。

document.SplitColumn( "1", ";", eeSplitIntoLines );

document.SplitColumn "1", ";", eeSplitIntoLines

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