Excel.SearchCriteria interface

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

Комментарии

Набор API: ExcelApi 1.9

Используется

Примеры

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    const table = sheet.tables.getItem("ExpensesTable");
    const searchRange = table.getRange();
    
    // Search for cells that exactly match "TODO", ignoring case, and starting from the top-left of the range and going forward.
    const searchCriteria: Excel.SearchCriteria = {
        completeMatch: true,
        matchCase: false,
        searchDirection: Excel.SearchDirection.forward
    };
    const foundRange = searchRange.findOrNullObject("TODO", searchCriteria);
    foundRange.load("address");
    await context.sync();

    if (foundRange.isNullObject) {
        console.log("Text not found");
    } else {
        console.log(foundRange.address);
    }
});

Свойства

completeMatch

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

matchCase

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

searchDirection

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

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

completeMatch

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

completeMatch?: boolean;

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

boolean

Комментарии

Набор API: ExcelApi 1.9

matchCase

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

matchCase?: boolean;

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

boolean

Комментарии

Набор API: ExcelApi 1.9

searchDirection

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

searchDirection?: Excel.SearchDirection | "Forward" | "Backwards";

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

Excel.SearchDirection | "Forward" | "Backwards"

Комментарии

Набор API: ExcelApi 1.9