API version 1

- ‐

isSelected

選択範囲が含まれるか否かを返します。

SpreadRange オブジェクトが選択されているかどうか(選択範囲に含まれているかどうか)を返します。 引数の指定によって判定方法が異なるため、結果が変わります。


SELECT_SAMEが指定された場合、選択範囲が1つ(の矩形範囲)のみで且つ選択範囲とSpreadRange オブジェクトの範囲が一致する場合のみtrueを返します。

呼出形式一覧

呼出形式

説明

boolean isSelected([integer selectedType])

選択範囲が含まれるか否かを返します。

戻り値一覧

戻り値

説明

boolean

範囲に選択範囲が含まれるかどうかを表す論理値

引数一覧

引数

説明

selectedType

動作モード。省略時はSELECT_SAMEとなります。
以下の定数のいずれかを指定します。

定数

動作

SELECT_SAME

0

選択範囲と一致している場合true

SELECT_CONTAIN

1

すべてが選択されている場合true

SELECT_PARTIAL

2

一部が選択されていればtrue

例外

なし

関連項目

select メソッド



使用例 CRSダウンロード

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

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

           var s = new SpreadStyle;
           s.bgColor = "#EEEEFF";
           range("B3:C6").style = s;

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

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   var r = ^.spread1.range("B3:C6");

                   #B3:C6が選択範囲と一致しているかどうかを取得します
                   if ( r.isSelected(SpreadRange.SELECT_SAME)) {
                           print( "B3:C6は選択範囲と同じです");

                   #B3:C6が選択範囲に含まれているかどうかを取得します
                   } else if ( r.isSelected(SpreadRange.SELECT_CONTAIN )) {
                           print("B3:C6は選択範囲に含まれています");

                   #B3:C6が選択範囲の一部に含まれているかどうかを取得します
                   } else if ( r.isSelected(SpreadRange.SELECT_PARTIAL)) {
                           print("B3:C6の一部が選択範囲に含まれます");
                   } else {
                           print( "B3:C6のセルのいずれも選択範囲に含まれていません");
                   }
           }
   }
}