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);
}
}
}