ExcelScript.WorksheetSearchCriteria interface

表示要使用的工作表搜索条件。

注解

示例

/**
 * 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

指定匹配是需要完整匹配还是部分匹配。 完全匹配与单元格的整个内容匹配。 部分匹配与单元格内容中的子字符串匹配 (例如, cat 部分匹配 caterpillarscatter) 。 默认值为 false (部分) 。

matchCase

指定匹配项是否区分大小写。 默认值 (false 不区分大小写) 。

属性详细信息

completeMatch

指定匹配是需要完整匹配还是部分匹配。 完全匹配与单元格的整个内容匹配。 部分匹配与单元格内容中的子字符串匹配 (例如, cat 部分匹配 caterpillarscatter) 。 默认值为 false (部分) 。

completeMatch?: boolean;

属性值

boolean

matchCase

指定匹配项是否区分大小写。 默认值 (false 不区分大小写) 。

matchCase?: boolean;

属性值

boolean