ExcelScript.SearchCriteria interface

Paquet:

ExcelScript

Représente les critères de recherche à utiliser.

Remarques

Exemples

/**
 * 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);
}

Propriétés

completeMatch	Spécifie si la correspondance doit être complète ou partielle. Une correspondance complète correspond à l’intégralité du contenu de la cellule. Une correspondance partielle correspond à une sous-chaîne dans le contenu de la cellule (par exemple, cat correspond partiellement à et scattercaterpillar ). La valeur par défaut est false (partielle).
matchCase	Spécifie si la correspondance respecte la casse. La valeur par défaut est false (ne respectant pas la casse).
searchDirection	Détermine le sens de la recherche. Par défaut est transférer. Voir ExcelScript.SearchDirection (en anglais).

Détails de la propriété

completeMatch

Spécifie si la correspondance doit être complète ou partielle. Une correspondance complète correspond à l’intégralité du contenu de la cellule. Une correspondance partielle correspond à une sous-chaîne dans le contenu de la cellule (par exemple, cat correspond partiellement à et scattercaterpillar ). La valeur par défaut est false (partielle).

completeMatch?: boolean;

Valeur de propriété

boolean

matchCase

Spécifie si la correspondance respecte la casse. La valeur par défaut est false (ne respectant pas la casse).

matchCase?: boolean;

Valeur de propriété

boolean

searchDirection

Détermine le sens de la recherche. Par défaut est transférer. Voir ExcelScript.SearchDirection (en anglais).

searchDirection?: SearchDirection;

Valeur de propriété

ExcelScript.SearchDirection