clipboardPaste¶

クリップボードの内容を選択範囲の左上を基準として貼り付けます。

copyable プロパティの設定とは無関係にクリップボードに貼り付け可能なデータが入っている場合は貼り付けが実行されます。

選択範囲が複数ある場合や、貼り付ける範囲の内と外にまたがった結合されたセルがある場合は例外が発生します。

貼り付ける範囲より選択範囲の方が大きい場合、貼り付ける範囲の他の部分のセルはクリアされます。

CLIPBOARDPASTEOPTIONS_OVERFLOWSELECTIONが指定された場合、クリップボードに保持されている範囲が選択範囲より大きい場合、選択範囲はクリップボードの範囲にあわせて自動的に拡張されます。

CLIPBOARDPASTEOPTIONS_TILINGPASTEが指定された場合、選択範囲がクリップボードに保持されている範囲よりも大きい場合、クリップボードの内容を繰り返し貼り付けます。選択範囲が行/列方向にクリップボードに保持されている範囲よりも小さい場合はクリップボードに保持されている範囲の行/列数に拡張されます。

クリップボード経由のデータのやり取りでは Spread オブジェクト同士の場合はスタイルを含めたデータがやり取りされますが、それ以外の場合はタブ区切りテキスト形式となります。

タブ区切りテキストの場合、各セルの値は、テキストが数字列で小数点ありの場合はNumber型、小数点なしの場合はInteger型、それ以外はString型になります。

呼出形式一覧

呼出形式

説明

void clipboardPaste([integer option])

クリップボードの内容を選択範囲の左上を基準として貼り付けます。省略時はCLIPBOARDPASTEOPTIONS_OVERFLOWSELECTIONです。

以下の定数のいずれかを指定します。

定数値	説明
CLIPBOARDPASTEOPTIONS_OVERFLOWSELECTION	1:選択範囲を拡張する。
CLIPBOARDPASTEOPTIONS_CLIPBYSELECTION	2:選択範囲を拡張しない。
CLIPBOARDPASTEOPTIONS_TILINGPASTE	3:繰り返し貼り付けを行う。

戻り値一覧

戻り値	説明
void	なし

例外

識別子	説明
CRS::Common::UI::Spread-3:1	選択範囲が複数あります。
CRS::Common::UI::Spread-3:2	結合されたセルの一部に重なっています。
CRS::Common::UI::Spread-3:3	セルがロックされています。

関連項目

copyable プロパティ

clipboardCopy 、 clipboardCut メソッド

使用例 CRSダウンロード

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

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

           spread1 << CSV {
                   1,2,3,4,5
                   2,3,4,5,6
                   3,4,5,6,7
                   4,5,6,7,8
           };

           maxColumns = 20;
           maxRows = 20;

           range("A1:B2").select();
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {

                   #選択範囲をクリップボードにコピーします
                   ^.spread1.clipboardCopy();

                   ^.spread1.cell("D3").select();

                   #選択範囲がクリップボードと同じになるようペーストを行います
                   ^.spread1.clipboardPaste(Spread.CLIPBOARDPASTEOPTIONS_OVERFLOWSELECTION);
           }
   }
}

clipboardPaste¶

ドキュメント目次

目次