hitTest メソッド

Javascript (Usage)
Javascript (Specification)

var instance = new GC.Spread.Sheets.Worksheet(name);
var value; // Type: Object

// パラメータ
var x; //タイプ： number
var y; //タイプ： number

value = instance.hitTest(x, y);

function hitTest( 
   x : number,
   y : number
) : Object;

パラメータ

x: x座標。
y: y座標。

戻り値の型

ヒットテスト情報。返される可能性のある戻り値とその説明の一覧については、「解説」を参照してください。

次のサンプルコードは、hitTestメソッドを使用します。

Javascript

$("#ss").click(function (e) {
    //Acquire cell index from mouse-clicked point of regular cells which are neither fixed rows/columns nor row/column headers.
    var offset = $("#ss").offset();
    var x = e.pageX - offset.left;
    var y = e.pageY - offset.top;
    var target = activeSheet.hitTest(x, y);

    if (target &&
        (target.rowViewportIndex === 0 || target.rowViewportIndex === 1) &&
        (target.colViewportIndex === 0 || target.colViewportIndex === 1)) {
        alert("Row index of mouse-clicked cells: " + target.row + "\n" + "Column index of mouse-clicked cells: " + target.col);
    }
});

このメソッドは以下の値を返します。

obj.x	number型	xパラメーターと等しいx座標。
obj.y	number型	yパラメーターと等しいy座標。
obj.rowViewportIndex	number型	行ビューポートのインデックス。-1は列ヘッダ領域、0は固定行領域、1はビューポート領域、2は固定末尾行領域をそれぞれ表します。
obj.colViewportIndex	number型	列ビューポートのインデックス。-1は行ヘッダ領域、0は固定列領域、1はビューポート領域、2は固定末尾列領域をそれぞれ表します。
obj.row	number型	点(x,y)が位置する行インデックス。
obj.col	number型	点(x,y)が位置する列インデックス。
obj.hitTestType	GC.Spread.Sheets.SheetArea型	点(x,y)が位置するシート領域。
obj.resizeInfo	object型	サイズ変更情報。
obj.resizeInfo.action	string型	"sizeRow"は行のサイズ変更、"sizeCol"は列のサイズ変更を表します。
obj.resizeInfo.index	number型	サイズ変更する行または列のインデックス。
obj.resizeInfo.sheetArea	GC.Spread.Sheets.SheetArea型	サイズ変更する行または列が位置するシート領域。
obj.groupHitInfo	object型	グループ情報。
obj.groupHitInfo.what	string型	"rgh"は行グループヘッダボタン、"cgh"は列グループヘッダボタン、"rg"は行グループボタン、"cg"は列グループボタン、"empty"はボタンなしをそれぞれ表します。
obj.groupHitInfo.info	object型	グループボタン情報。
obj.groupHitInfo.info.index	number型	範囲グループの集計インデックス。
obj.groupHitInfo.info.isExpanded	boolean型	範囲グループが展開されているかどうか。
obj.groupHitInfo.info.level	number型	範囲グループのレベル。
obj.groupHitInfo.info.lineDirection	GC.Spread.Sheets.RangeGroupDirection型	範囲グループの方向。
obj.groupHitInfo.info.paintLine	boolean型	範囲グループの線を描画するかどうか。
obj.filterButtonHitInfo	object型	フィルタボタン情報。
obj.filterButtonHitInfo.row	number型	フィルタボタンが位置する行インデックス。
obj.filterButtonHitInfo.col	number型	フィルタボタンが位置する列インデックス。
obj.filterButtonHitInfo.x	number型	フィルタボタンのx座標。
obj.filterButtonHitInfo.y	number型	フィルタボタンのy座標。
obj.filterButtonHitInfo.width	number型	フィルタボタンの幅。
obj.filterButtonHitInfo.height	number型	フィルタボタンの高さ。
obj.filterButtonHitInfo.sheetArea	GC.Spread.Sheets.SheetArea型	フィルタボタンが位置するシート領域。
obj.dragInfo	object型	ドラッグ情報。
obj.dragInfo.action	string型	"drag"はドラッグ＆ドロップまたはドラッグ＆フィルを表します。
obj.dragInfo.side	string型	"left"、"right"、"top"、"bottom"はドラッグ＆ドロップを表し、"corner"はドラッグ＆フィルを表します。
obj.dragInfo.outside	boolean型	操作がアクティブな選択範囲の範囲外かどうか。
obj.cellTypeHitInfo	object型	セル型情報。
obj.cellTypeHitInfo.x	number型	xパラメーターと等しいx座標。
obj.cellTypeHitInfo.y	number型	yパラメーターと等しいy座標。
obj.cellTypeHitInfo.row	number型	セルの行インデックス。
obj.cellTypeHitInfo.col	number型	セルの列インデックス。
obj.cellTypeHitInfo.cellRect	GC.Spread.Sheets.Rect型	セルの矩形。
obj.cellTypeHitInfo.sheetArea	GC.Spread.Sheets.SheetArea型	セルのシート領域。
obj.cellTypeHitInfo.isReservedLocation	boolean型	点(x,y)が、セル型が処理しなければならない特別な領域に位置するかどうか。

参照

Worksheet タイプ