データの検索

ウィジェット内のテキストを検索できます。また、大文字小文字の区別、完全一致、ワイルドカード、検索対象のセル範囲、検索順序といったさまざまな検索オプションを指定できます。searchメソッドおよびSearchConditionクラスを使用して、セルテキスト、セルタグ、コメント、セル値、または数式を検索することができます。

さらに、SearchFoundFlags列挙型は、検索の対象を決定し、検索が実行される場所を指定します。また、セルの値、数式、セルタグ、コメント内を検索するためのいくつかのフラグオプションも含まれています。

メモ：
条件を検索する際には、SearchFlagsとSearchOrderで定義されたルールが適用されます。
コメントを検索する場合、コメント内のテキストが検索の対象となります。
セルコメント（Excelではメモ）が設定されたExcelファイルをインポートした場合、SpreadJSでは、コメントの検索時にコメント内のユーザー名とテキストの両方を検索対象とします。

コードの使用

以下のコードは、セルのコメントを検索対象として文字列を検索する方法を示しています。検索条件に応じて検索対象の値を変更できます。

var sheet = spread.getSheet(0);
sheet.getCell(2,3).value("user");

// コメントを追加します
var comment = new GC.Spread.Sheets.Comments.Comment();
comment.text("user comment!");

// コメントを検索します
var searchCondition = new GC.Spread.Sheets.Search.SearchCondition();
searchCondition.searchString = "user";
searchCondition.startSheetIndex = spread.getActiveSheetIndex();
searchCondition.endSheetIndex = spread.getActiveSheetIndex();
searchCondition.searchOrder = GC.Spread.Sheets.Search.SearchOrder.nOrder;

// 検索対象をセルコメントに設定します
searchCondition.searchTarget = GC.Spread.Sheets.Search.SearchFoundFlags.cellComment;

// 検索対象をセルのテキストにします
// searchCondition.searchTarget = GC.Spread.Sheets.Search.SearchFoundFlags.CellText; 

searchCondition.searchFlags = GC.Spread.Sheets.Search.SearchFlags.ignoreCase | GC.Spread.Sheets.Search.SearchFlags.useWildCards;
var searchresult = spread.search(searchCondition);
var str = "[searchFoundFlag:" + searchresult.searchFoundFlag + ",\r\n foundSheetIndex:" + searchresult.foundSheetIndex + ",foundRowIndex:" +
searchresult.foundRowIndex + ", foundColumnIndex:" + searchresult.foundColumnIndex + ", foundComment:" + searchresult.foundString + "]";
console.log(str);

デザイナの使用

SpreadJSデザイナでは、以下の手順に従って、検索と置換ダイアログボックスを使用して、値、セルタグ、数式、セルコメントを含む文字列を検索できます。

ホームタブの検索ボタンをクリックします。検索と置換ダイアログボックスが表示されます。
ダイアログボックスで オプション>> ボタンをクリックします。
検索対象ドロップダウンをクリックし、必要に応じて検索条件に基づいて任意のオプションを選択します。

以下の画像は、検索で選択できるさまざまなオプションが表示された検索と置換ダイアログボックスを示しています。

find_replace_dialog