ExcelScript.SearchCriteria interface

Пакет:

ExcelScript

Представляет используемые критерии поиска.

Комментарии

Примеры

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

Свойства

completeMatch	Указывает, должно ли совпадение быть полным или частичным. Полное совпадение соответствует всему содержимому ячейки. Частичное совпадение соответствует подстроку в содержимом ячейки (например, cat частично соответствует caterpillar и scatter). Значение по умолчанию — false (частичное).
matchCase	Указывает, учитывается ли совпадение с учетом регистра. Значение по умолчанию — false (без учета регистра).
searchDirection	Указывает направление поиска. Значение по умолчанию: вперед. См. раздел ExcelScript.SearchDirection.

Сведения о свойстве

completeMatch

Указывает, должно ли совпадение быть полным или частичным. Полное совпадение соответствует всему содержимому ячейки. Частичное совпадение соответствует подстроку в содержимом ячейки (например, cat частично соответствует caterpillar и scatter). Значение по умолчанию — false (частичное).

completeMatch?: boolean;

Значение свойства

boolean

matchCase

Указывает, учитывается ли совпадение с учетом регистра. Значение по умолчанию — false (без учета регистра).

matchCase?: boolean;

Значение свойства

boolean

searchDirection

Указывает направление поиска. Значение по умолчанию: вперед. См. раздел ExcelScript.SearchDirection.

searchDirection?: SearchDirection;

Значение свойства

ExcelScript.SearchDirection