ExcelScript.SearchCriteria interface

Paket:

ExcelScript

Stellt die zu verwendenden Suchkriterien dar.

Hinweise

Beispiele

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

Eigenschaften

completeMatch	Gibt an, ob die Übereinstimmung vollständig oder teilweise sein muss. Eine vollständige Übereinstimmung entspricht dem gesamten Inhalt der Zelle. Eine partielle Übereinstimmung entspricht einer Teilzeichenfolge innerhalb des Zellinhalts (z. cat B. teilweise übereinstimmungen caterpillar und scatter). Der Standardwert ist false (partielle).
matchCase	Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (ohne Berücksichtigung der Groß-/Kleinschreibung).
searchDirection	Gibt die Suchrichtung an. Der Standardwert ist vorwärts. Weitere Informationen finden Sie unter ExcelScript.SearchDirection.

Details zur Eigenschaft

completeMatch

Gibt an, ob die Übereinstimmung vollständig oder teilweise sein muss. Eine vollständige Übereinstimmung entspricht dem gesamten Inhalt der Zelle. Eine partielle Übereinstimmung entspricht einer Teilzeichenfolge innerhalb des Zellinhalts (z. cat B. teilweise übereinstimmungen caterpillar und scatter). Der Standardwert ist false (partielle).

completeMatch?: boolean;

Eigenschaftswert

boolean

matchCase

Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (ohne Berücksichtigung der Groß-/Kleinschreibung).

matchCase?: boolean;

Eigenschaftswert

boolean

searchDirection

Gibt die Suchrichtung an. Der Standardwert ist vorwärts. Weitere Informationen finden Sie unter ExcelScript.SearchDirection.

searchDirection?: SearchDirection;

Eigenschaftswert

ExcelScript.SearchDirection