ExcelScript.SearchCriteria interface

Pacote:

ExcelScript

Representa os critérios de pesquisa a utilizar.

Comentários

Exemplos

/**
 * This script searches for the next instance of the text "TK" on the current worksheet.
 * It then selects that cell and removes "TK" and all formatting from the cell.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the used range on the current worksheet.
  let range = workbook.getActiveWorksheet().getUsedRange();

  // Get the next cell that contains "TK".
  let tkCell = range.find("TK", {
    completeMatch: true, /* Don't match if the cell text only contains "TK" as part of another string. */
    matchCase: false,
    searchDirection: ExcelScript.SearchDirection.forward /* Start at the beginning of the range and go to later columns and rows. */
  });

  // Set focus on the found cell.
  tkCell.select();

  // Remove the "TK" text value from the cell, as well as any formatting that may have been added.
  tkCell.clear(ExcelScript.ClearApplyTo.all);
}

Propriedades

completeMatch	Especifica se a correspondência tem de ser completa ou parcial. Uma correspondência completa corresponde a todo o conteúdo da célula. Uma correspondência parcial corresponde a uma subcadeia dentro do conteúdo da célula (por exemplo, cat corresponde parcialmente a escatter ).caterpillar A predefinição é false (parcial).
matchCase	Especifica se a correspondência é sensível a maiúsculas e minúsculas. A predefinição é false (não sensível a maiúsculas e minúsculas).
searchDirection	Especifica a direção da pesquisa. O padrão é para frente. Consulte ExcelScript.SearchDirection.

Detalhes da propriedade

completeMatch

Especifica se a correspondência tem de ser completa ou parcial. Uma correspondência completa corresponde a todo o conteúdo da célula. Uma correspondência parcial corresponde a uma subcadeia dentro do conteúdo da célula (por exemplo, cat corresponde parcialmente a escatter ).caterpillar A predefinição é false (parcial).

completeMatch?: boolean;

Valor da propriedade

boolean

matchCase

Especifica se a correspondência é sensível a maiúsculas e minúsculas. A predefinição é false (não sensível a maiúsculas e minúsculas).

matchCase?: boolean;

Valor da propriedade

boolean

searchDirection

Especifica a direção da pesquisa. O padrão é para frente. Consulte ExcelScript.SearchDirection.

searchDirection?: SearchDirection;

Valor da propriedade

ExcelScript.SearchDirection