API version 1

- ‐

saveText

writerオブジェクトにテキストファイルを出力します。

引数には、テキストファイル内でのデータ区切り文字（デリミタ）を指定する必要があります。

列デリミタは、列の区切り文字として使用されます。

行デリミタは、行の区切り文字として使用されます。

セルデリミタは、セルデータに列デリミタで指定される文字、行デリミタで指定された文字、セルデリミタで指定された文字が含まれる場合に、前後に付与される文字です。

チェックボックス型のセルは、valueプロパティ設定そのものではなく、チェック状態の判定値(0～2)が出力されます。 ただし、SAVE_CHECKBOXFALSEを指定しない場合は、0の代わりに空白文字列を出力します。

SAVE_UNFORMATTEDDATAが指定されていない場合はtextプロパティの内容が出力されます。

SAVE_COLUMNHEADERS、SAVE_ROWHEADERSが指定され、列/行ヘッダのタイトルが空白文字列の場合、タイトルには SpreadHeader.autoText プロパティの設定に従った文字列が出力されます。

呼出形式一覧

呼出形式	説明
void saveText(writable writer, string cellDelim, string colDelim, string rowDelim, integer flags)	writerオブジェクトにテキストファイルを出力します。

戻り値一覧

戻り値	説明
void	なし

引数一覧

引数	説明
writer	出力先のwritableオブジェクト
cellDelim	セルデリミタを表す文字列。空白文字列が指定された場合は二重引用符(")となります。
colDelim	列デリミタを表す文字列。空白文字列が指定された場合はタブコードとなります。
rowDelim	行デリミタを表す文字列。空白文字列が指定された場合は、改行コードとなります。
flags	ファイルの作成方法。 以下の値の組み合わせを指定します。 定数 値 動作 Spread.SAVE_UNFORMATTEDDATA 4 valueプロパティの内容を出力 Spread.SAVE_COLUMNHEADERS 8 列ヘッダのタイトルを出力 Spread.SAVE_ROWHEADERS 16 行ヘッダのタイトルを出力 Spread.SAVE_ALLHEADERS 24 両ヘッダのタイトルを出力 Spread.SAVE_CHECKBOXFALSE 32 チェックされていないチェックボックス型セルは0を出力

例外

識別子	説明
CRS::Common::Core-2:2	有効なwritableオブジェクトが指定されていません

関連項目

SpreadStyleCheckBox クラス

SpreadHeader.autoText プロパティ

loadText 、 Spread.saveText メソッド

readableオブジェクト、writableオブジェクト

使用例 CRSダウンロード

Form SpreadRange_saveText {
   x = 0;
   y = 0;
   width = 800;
   height = 600;

   Spread spread1 {
           x = 8;
           y = 8;
           width = 640;
           height = 440;

           spread1 << CSV {
                   1000,2000,3000,This is "test"
                   1000,2000,3000,This is test
           };

           maxColumns = 20;
           maxRows = 20;

           var s = new SpreadStyle;
           s.format = "#,#\"円\"";

           range("A1:C1").style = s;
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   var file = FileSystem.saveDialog("saveText", "テキストファイル(*.txt)", "*.txt", "");
                   if (file.isValid) {
                           #fileオブジェクトに両ヘッダのタイトルと共にA1:D2の範囲を出力します
                           ^.spread1.range("A1:D2").saveText(file,"","","",Spread.SAVE_ALLHEADERS);
                   }
           }
   }
}