API version 1

- ‐

getFirstValidCell

有効な左上のセルを返します。

行の高さや列の幅が0の場合など、表示されていないセルを除いた最初の有効なセルを調べることができます。

Spread.editModePermanent プロパティがtrueの場合は、ロックされたセルやラベル型のセルなど、編集不可能なセルは、有効なセルとして扱いません。

左上のセルが有効なセルでない場合は、最初に出現する有効な右隣のセルを返します。

一番上の行のセルがいずれも有効なセルでない場合は、その１行下のセルについて最初に出現する有効なセルを返します。

有効なセルがない場合はnullを返します。

呼出形式一覧

呼出形式	説明
CRS::Common::Spread::SpreadCell getFirstValidCell()	有効な左上のセルを返します。

戻り値一覧

戻り値	説明
CRS::Common::Spread::SpreadCell	有効な左上のセルへのアクセッサ

例外

なし

関連項目

Spread.editModePermanent プロパティ

getLastValidCell メソッド

使用例 CRSダウンロード

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

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

           editModePermanent = true;

           var s = new SpreadStyleLabel;
           cell("A1").style = s;

           cell("A1").value = "Label";
           cell("B1").value = "Normal";
   }

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   #A1:C3の矩形範囲内の有効な左上のセルを取得します。左上が有効でない場合はその右隣のセルを返します
                   var c = ^.spread1.range("A1:C3").getFirstValidCell();
                   if ( c != null ) {
                           c.activate();
                   }
           }
   }
}