API version 1

- ‐

ensureVisible

セルが指定の位置に表示されるようにスプレッドシートをスクロールします。

スクロールして表示範囲を変更するのみで、アクティブセルは移動しません。

また、スクロール範囲を超えた表示範囲の変更も行われません。 そのため、最下行のセルに対してPOSITION_UPPERLEFTやPOSITION_CENTERLEFTを指定してensureVisibleを実行しても、最下行の表示は表示範囲の下のままです

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

定数値	説明
POSITION_NEAREST	0:スクロール量が一番小さくなるような場所
POSITION_UPPERLEFT	1:表示範囲の左上
POSITION_UPPERCENTER	2:表示範囲の最上段中央
POSITION_UPPERRIGHT	3:表示範囲の右上
POSITION_CENTERLEFT	4:表示範囲の上下中央、左
POSITION_CENTER	5:表示範囲の中央
POSITION_CENTERRIGHT	6:表示範囲の上下中央、右
POSITION_BOTTOMLEFT	7:表示範囲の左下
POSITION_BOTTOMCENTER	8:表示範囲の最下段中央
POSITION_BOTTOMRIGHT	9:表示範囲の右下

呼出形式一覧

呼出形式	説明
void ensureVisible([integer position])	セルが指定の位置に表示されるようにスプレッドシートをスクロールします。

戻り値一覧

戻り値	説明
void	なし

引数一覧

引数	説明
position	スクロール後のセルの表示位置を指定します。省略時はPOSITION_NEARESTとなります。

例外

識別子	説明
SYS-23:5	メソッドの引数が不正です

使用例 CRSダウンロード

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

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

   Button button1 {
           x = 664;
           y = 32;
           width = 112;
           height = 32;
           title = "実行";
           function onTouch(e) {
                   #C3セルが左上になるよう表示範囲を変更します
                   ^.spread1.cell("C3").ensureVisible(spreadcell.POSITION_UPPERLEFT);
           }
   }
}