API version 2
- ‐
loadText¶
readerオブジェクトからテキストファイルを読み込みます。
SpreadRange オブジェクトをクリア後、テキストファイルを読み込みます。
引数には、テキストファイル内でのデータ区切り文字（デリミタ）を指定する必要があります。
セルデリミタは、セルデータの前後に付与されていると見なす文字です。セルデータ中に指定された文字が続けて出現した場合は、その文字がセルデータ内にあると識別します。
読み込んだセルデータがイコール(=)で始まる場合は、数式としてセルの formula プロパティに設定されます。それ以外の場合は value プロパティに設定されます。
LOAD_CLEARDATAONLYを指定した場合、セルのスタイルはクリアされません。指定しない場合は、セルのスタイルと値がクリアされます。
loadText メソッドでは、矩形範囲をクリア後、readerオブジェクトの内容を矩形範囲の各セルに設定します。そのため、readerオブジェクトの範囲外の矩形範囲に設定されていたデータはメソッド実行時にクリアされます。
セルの合成スタイルがSpreadStyleTextまたはSpreadStyleComboBoxの場合は、合成スタイルのsubTypeに基づいて、貼り付けるテキストからの型推定が行われます(セル編集時と同様)。 (LOAD_CLEARDATAONLYを指定した場合は、SpreadRow/SpreadColumnなどのスタイル設定に基づいて判定されます)
合成スタイルのsubType |
テキストの内容 |
value 設定型 |
value 設定値 |
|---|---|---|---|
Integer |
数字列(小数点なし) |
Integer |
テキストが示す数値 |
数字列(小数点あり) |
整数に切り捨て |
||
日付・時刻表示 |
日付に対応するシリアル数値 |
||
上記以外 |
String |
テキストそのまま |
|
Number |
数字列(小数点なし) |
Number |
テキストが示す数値 |
数字列(小数点あり) |
|||
日付・時刻表示 |
日付時刻に対応するシリアル数値 |
||
上記以外 |
String |
テキストそのまま |
|
Fixed |
数字列(小数点なし) |
Fixed |
テキストが示す数値 |
数字列(小数点あり) |
|||
日付・時刻表示 |
日付時刻に対応するシリアル数値 |
||
上記以外 |
String |
テキストそのまま |
|
Date |
数字列(小数点なし) |
Date |
シリアルに対応する日付 |
数字列(小数点あり) |
シリアルに対応する日付時刻 |
||
日付・時刻表示 |
テキストが示す日付時刻 |
||
上記以外 |
String |
テキストそのまま |
|
Number |
数字列(小数点なし) |
String |
テキストそのまま |
数字列(小数点あり) |
|||
日付・時刻表示 |
|||
上記以外 |
|||
上記以外 |
数字列(小数点なし) |
Integer |
テキストが示す数値 |
数字列(小数点あり) |
Number |
テキストが示す数値 |
|
日付・時刻表示 |
Date |
テキストが示す日付時刻 |
|
上記以外 |
String |
テキストそのまま |
また、読み込み元の矩形範囲が readerオブジェクトの内容よりも狭い場合、はみ出た部分は無視されます。
呼出形式一覧
呼出形式 |
説明 |
|---|---|
void loadText(readable reader, string cellDelim, string colDelim, string rowDelim, integer flags) |
readerオブジェクトからテキストファイルを読み込みます。 |
戻り値一覧
戻り値 |
説明 |
|---|---|
void |
なし |
引数一覧
引数 |
説明 |
|||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
reader |
読み込み元のreadableオブジェクト |
|||||||||||||||
cellDelim |
セルデリミタを表す文字列。空白文字列が指定された場合は二重引用符(")となります。 |
|||||||||||||||
colDelim |
列デリミタを表す文字列。空白文字列が指定された場合はタブコードとなります。 |
|||||||||||||||
rowDelim |
行デリミタを表す文字列。空白文字列が指定された場合は、改行コードとなります。 |
|||||||||||||||
flags |
ファイルの読み込み方法
以下の値の組み合わせを指定します。
|
例外
識別子 |
説明 |
|---|---|
CRS::Common::Core-2:1 |
有効なreadableオブジェクトが指定されていません |
CRS::Common::UI::Spread-3:2 |
結合されたセルの一部に重なっています。 |
CRS::Common::UI::Spread-3:3 |
セルがラベル型もしくはロックされています。 |
関連項目