ExcelScript.WorksheetSearchCriteria interface

  • リファレンス
パッケージ:
ExcelScript

使用するワークシートの検索条件を表します。

注釈

例

/**
 * This script searches through a worksheet and finds cells containing "No". 
 * Those cells are filled with the color red.
 * Use Range.find instead of Worksheet.findAll when you want to limit the search to a specific range.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current, active worksheet.
  const worksheet = workbook.getActiveWorksheet();

  // Get all the cells that exactly contain the string "No".
  const searchCriteria: ExcelScript.WorksheetSearchCriteria = { 
    completeMatch: true,
    matchCase: true
  };
  const noCells = worksheet.findAll("No", searchCriteria);

  // Set the fill color to red.
  noCells.getFormat().getFill().setColor("red");
}

プロパティ

completeMatch

一致が完全であるか部分的である必要があるかどうかを指定します。 完全一致は、セルの内容全体と一致します。 部分一致は、セルのコンテンツ内の部分文字列と一致します (たとえば、caterpillarとscatterに部分的に一致cat)。 既定値は false (部分) です。
matchCase

一致で大文字と小文字が区別されるかどうかを指定します。 既定値は false です (大文字と小文字は区別されません)。

プロパティの詳細

completeMatch

一致が完全であるか部分的である必要があるかどうかを指定します。 完全一致は、セルの内容全体と一致します。 部分一致は、セルのコンテンツ内の部分文字列と一致します (たとえば、caterpillarとscatterに部分的に一致cat)。 既定値は false (部分) です。

completeMatch?: boolean;

プロパティ値

boolean

matchCase

一致で大文字と小文字が区別されるかどうかを指定します。 既定値は false です (大文字と小文字は区別されません)。

matchCase?: boolean;

プロパティ値

boolean