ExcelScript.Application interface
Stellt die Excel-Anwendung dar, die die Arbeitsmappe verwaltet.
Methoden
| calculate(calculation |
Alle in Excel geöffnete Arbeitsmappen werden neu berechnet. |
| get |
Gibt die Version der Excel-Berechnungsmaschine zurück, die für die letzte vollständige Neuberechnung verwendet wurde. |
| get |
Gibt den in der Arbeitsmappe verwendeten Berechnungsmodus zurück, der durch die Konstanten in |
| get |
Gibt den Berechnungszustand der Anwendung zurück. Weitere Informationen finden Sie unter |
| get |
Stellt Informationen basierend auf den aktuellen Systemkultureinstellungen bereit. Dies umfasst die Kulturnamen, die Zahlenformatierung und andere kulturabhängige Einstellungen. |
| get |
Ruft die Zeichenfolge ab, die als Dezimaltrennzeichen für numerische Werte verwendet wird. Dies basiert auf den lokalen Excel-Einstellungen. |
| get |
Gibt die iterativen Berechnungseinstellungen zurück. In Excel unter Windows und Mac gelten die Einstellungen für die Excel-Anwendung. Auf Excel im Web und anderen Plattformen gelten die Einstellungen für die aktive Arbeitsmappe. |
| get |
Ruft die Zeichenfolge ab, mit der Gruppen von Ziffern links vom Dezimaltrennzeichen für numerische Werte getrennt werden. Dies basiert auf den lokalen Excel-Einstellungen. |
| get |
Gibt an, ob die Systemtrennzeichen von Excel aktiviert sind. Systemtrennzeichen enthalten das Dezimaltrennzeichen und das Tausendertrennzeichen. |
| set |
Gibt den in der Arbeitsmappe verwendeten Berechnungsmodus zurück, der durch die Konstanten in |
Details zur Methode
calculate(calculationType)
Alle in Excel geöffnete Arbeitsmappen werden neu berechnet.
calculate(calculationType: CalculationType): void;Parameter
- calculationType
- ExcelScript.CalculationType
Gibt den zu verwendenden Berechnungstyp an. Weitere Informationen finden Sie unter ExcelScript.CalculationType .
Gibt zurück
void
Beispiele
/**
* This script fully recalculates the entire workbook.
* This code is useful when automatic recalculation is turned off
* but later parts of the script rely on updated values.
*/
function main(workbook: ExcelScript.Workbook, workbookURL: string) {
const application = workbook.getApplication();
application.calculate(ExcelScript.CalculationType.fullRebuild);
}
getCalculationEngineVersion()
Gibt die Version der Excel-Berechnungsmaschine zurück, die für die letzte vollständige Neuberechnung verwendet wurde.
getCalculationEngineVersion(): number;Gibt zurück
number
getCalculationMode()
Gibt den in der Arbeitsmappe verwendeten Berechnungsmodus zurück, der durch die Konstanten in ExcelScript.CalculationModedefiniert wird. Mögliche Werte sind: Automatic, wobei Excel die Neuberechnung steuert; AutomaticExceptTables, wobei Excel die Neuberechnung steuert, aber Änderungen in Tabellen ignoriert; Manual, wobei die Berechnung durchgeführt wird, wenn der Benutzer sie anfordert.
getCalculationMode(): CalculationMode;Gibt zurück
getCalculationState()
Gibt den Berechnungszustand der Anwendung zurück. Weitere Informationen finden Sie unter ExcelScript.CalculationState .
getCalculationState(): CalculationState;Gibt zurück
Beispiele
/**
* This script uses the fill color of the first cell to indicate the current
* calculation state of the workbook.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the first cell in the first worksheet.
const cell = workbook.getWorksheets()[0].getCell(0,0);
// Get that cell's fill object.
const cellFill = cell.getFormat().getFill();
// Set the cell fill based on the calculation state.
const calcState = workbook.getApplication().getCalculationState();
switch (calcState) {
case ExcelScript.CalculationState.pending:
cellFill.setColor("Red");
break;
case ExcelScript.CalculationState.calculating:
cellFill.setColor("Yellow");
break;
case ExcelScript.CalculationState.done:
cellFill.setColor("Green");
break;
}
}
getCultureInfo()
Stellt Informationen basierend auf den aktuellen Systemkultureinstellungen bereit. Dies umfasst die Kulturnamen, die Zahlenformatierung und andere kulturabhängige Einstellungen.
getCultureInfo(): CultureInfo;Gibt zurück
getDecimalSeparator()
Ruft die Zeichenfolge ab, die als Dezimaltrennzeichen für numerische Werte verwendet wird. Dies basiert auf den lokalen Excel-Einstellungen.
getDecimalSeparator(): string;Gibt zurück
string
getIterativeCalculation()
Gibt die iterativen Berechnungseinstellungen zurück. In Excel unter Windows und Mac gelten die Einstellungen für die Excel-Anwendung. Auf Excel im Web und anderen Plattformen gelten die Einstellungen für die aktive Arbeitsmappe.
getIterativeCalculation(): IterativeCalculation;Gibt zurück
getThousandsSeparator()
Ruft die Zeichenfolge ab, mit der Gruppen von Ziffern links vom Dezimaltrennzeichen für numerische Werte getrennt werden. Dies basiert auf den lokalen Excel-Einstellungen.
getThousandsSeparator(): string;Gibt zurück
string
getUseSystemSeparators()
Gibt an, ob die Systemtrennzeichen von Excel aktiviert sind. Systemtrennzeichen enthalten das Dezimaltrennzeichen und das Tausendertrennzeichen.
getUseSystemSeparators(): boolean;Gibt zurück
boolean
setCalculationMode(calculationMode)
Gibt den in der Arbeitsmappe verwendeten Berechnungsmodus zurück, der durch die Konstanten in ExcelScript.CalculationModedefiniert wird. Mögliche Werte sind: Automatic, wobei Excel die Neuberechnung steuert; AutomaticExceptTables, wobei Excel die Neuberechnung steuert, aber Änderungen in Tabellen ignoriert; Manual, wobei die Berechnung durchgeführt wird, wenn der Benutzer sie anfordert.
setCalculationMode(calculationMode: CalculationMode): void;Parameter
- calculationMode
- ExcelScript.CalculationMode
Gibt zurück
void
Office Scripts