ExcelScript.SearchCriteria interface
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
complete |
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. |
match |
Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist |
search |
Gibt die Suchrichtung an. Der Standardwert ist vorwärts. Weitere Informationen finden Sie unter |
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
Office Scripts