Excel.Interfaces.RangeUpdateData interface
Eine Schnittstelle zum Aktualisieren von Daten über das Range Objekt, zur Verwendung in range.set({ ... }).
Eigenschaften
| column |
Gibt an, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Wert ist |
| control | Greift auf das auf diesen Bereich angewendete Zellensteuerelement zu. Wenn der Bereich über mehrere Zellsteuerelemente verfügt, wird zurückgegeben |
| data |
Gibt ein Datenüberprüfungsobjekt zurück. |
| format | Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt. |
| formula |
Gibt die Arrayformel eines Bereichs an. Wenn der angegebene Bereich keine Matrixformel enthält, gibt diese Eigenschaft zurück |
| formulas | Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben. |
| formulas |
Stellt die Formel in der A1-Schreibweise, Sprache des Benutzers und im Gebietsschema der Zahlenformatierung dar. Beispielsweise würde die englische Formel „= SUM(A1, 1.5)“ in Deutsch „= SUMME(A1; 1,5)“ werden. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben. |
| formulasR1C1 | Stellt die Formel in der R1C1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben. |
| hyperlink | Stellt den Hyperlink für den aktuellen Bereich dar. |
| number |
Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes. |
| number |
Stellt den Excel-Zahlenformatcode für den angegebenen Bereich auf der Grundlage der Spracheinstellungen des Benutzers dar. Excel führt beim Abrufen oder Festlegen der |
| row |
Gibt an, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Wert ist |
| style | Stellt die Formatvorlage des aktuellen Bereichs dar. Wenn die Formatvorlagen der Zellen inkonsistent sind, |
| values | Stellt die Rohwerte des angegebenen Bereichs dar. Bei den zurückgegebenen Daten kann es sich um Zeichenfolgen, Zahlen oder boolesche Werte handeln. Zellen, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück. Wenn der zurückgegebene Wert mit einem Pluszeichen ("+"), einem Minuszeichen ("-") oder einem Gleichheitszeichen ("=") beginnt, interpretiert Excel diesen Wert als Formel. |
| values |
Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz |
| values |
Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz |
Details zur Eigenschaft
columnHidden
Gibt an, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Wert ist true , wenn alle Spalten in einem Bereich ausgeblendet sind. Wert ist false , wenn keine Spalten im Bereich ausgeblendet sind. Ein Wert ist null , wenn einige Spalten in einem Bereich ausgeblendet und andere Spalten im selben Bereich nicht ausgeblendet sind.
columnHidden?: boolean;
Eigenschaftswert
boolean
Hinweise
control
Greift auf das auf diesen Bereich angewendete Zellensteuerelement zu. Wenn der Bereich über mehrere Zellsteuerelemente verfügt, wird zurückgegeben EmptyCellControl.
control?: CellControl;
Eigenschaftswert
Hinweise
dataValidation
Gibt ein Datenüberprüfungsobjekt zurück.
dataValidation?: Excel.Interfaces.DataValidationUpdateData;
Eigenschaftswert
Hinweise
format
Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt.
format?: Excel.Interfaces.RangeFormatUpdateData;
Eigenschaftswert
Hinweise
formulaArray
Gibt die Arrayformel eines Bereichs an. Wenn der angegebene Bereich keine Matrixformel enthält, gibt diese Eigenschaft zurück null.
formulaArray?: string;
Eigenschaftswert
string
Hinweise
formulas
Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulas?: any[][];
Eigenschaftswert
any[][]
Hinweise
formulasLocal
Stellt die Formel in der A1-Schreibweise, Sprache des Benutzers und im Gebietsschema der Zahlenformatierung dar. Beispielsweise würde die englische Formel „= SUM(A1, 1.5)“ in Deutsch „= SUMME(A1; 1,5)“ werden. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasLocal?: any[][];
Eigenschaftswert
any[][]
Hinweise
formulasR1C1
Stellt die Formel in der R1C1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasR1C1?: any[][];
Eigenschaftswert
any[][]
Hinweise
hyperlink
Stellt den Hyperlink für den aktuellen Bereich dar.
hyperlink?: Excel.RangeHyperlink;
Eigenschaftswert
Hinweise
numberFormat
Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.
numberFormat?: any[][];
Eigenschaftswert
any[][]
Hinweise
numberFormatLocal
Stellt den Excel-Zahlenformatcode für den angegebenen Bereich auf der Grundlage der Spracheinstellungen des Benutzers dar. Excel führt beim Abrufen oder Festlegen der numberFormatLocal Eigenschaft keine Sprach- oder Formatkonvertierung aus. Jeder zurückgegebene Text verwendet die lokal formatierten Zeichenfolgen basierend auf der in den Systemeinstellungen angegebenen Sprache.
numberFormatLocal?: any[][];
Eigenschaftswert
any[][]
Hinweise
rowHidden
Gibt an, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Wert ist true , wenn alle Zeilen in einem Bereich ausgeblendet sind. Wert ist false , wenn keine Zeilen im Bereich ausgeblendet sind. Ein Wert ist null , wenn einige Zeilen in einem Bereich ausgeblendet sind und andere Zeilen im selben Bereich nicht.
rowHidden?: boolean;
Eigenschaftswert
boolean
Hinweise
style
Stellt die Formatvorlage des aktuellen Bereichs dar. Wenn die Formatvorlagen der Zellen inkonsistent sind, null wird zurückgegeben. Bei benutzerdefinierten Formatvorlagen wird der Formatvorlagenname zurückgegeben. Bei integrierten Formatvorlagen wird eine Zeichenfolge zurückgegeben, die einen Wert in der BuiltInStyle Aufzählung darstellt.
style?: string;
Eigenschaftswert
string
Hinweise
values
Stellt die Rohwerte des angegebenen Bereichs dar. Bei den zurückgegebenen Daten kann es sich um Zeichenfolgen, Zahlen oder boolesche Werte handeln. Zellen, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück. Wenn der zurückgegebene Wert mit einem Pluszeichen ("+"), einem Minuszeichen ("-") oder einem Gleichheitszeichen ("=") beginnt, interpretiert Excel diesen Wert als Formel.
values?: any[][];
Eigenschaftswert
any[][]
Hinweise
valuesAsJson
Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz Range.valueszu unterstützt unterstützt dies alle Datentypen, Range.valuesAsJson die sich in einer Zelle befinden können. Beispiele sind neben den standardmäßigen booleschen, numerischen und Zeichenfolgenwerten auch formatierte Zahlenwerte und Webbilder. Von dieser API zurückgegebene Daten stimmen immer mit dem Gebietsschema en-US überein. Um Daten im Anzeigegebietsschema des Benutzers abzurufen, verwenden Sie Range.valuesAsJsonLocal.
valuesAsJson?: CellValue[][];
Eigenschaftswert
Excel.CellValue[][]
Hinweise
valuesAsJsonLocal
Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz Range.valueszu unterstützt unterstützt dies alle Datentypen, Range.valuesAsJsonLocal die sich in einer Zelle befinden können. Beispiele sind neben den standardmäßigen booleschen, numerischen und Zeichenfolgenwerten auch formatierte Zahlenwerte und Webbilder. Die von dieser API zurückgegebenen Daten entsprechen immer dem Anzeigegebietsschema des Benutzers. Um Daten unabhängig vom Gebietsschema abzurufen, verwenden Sie Range.valuesAsJson.
valuesAsJsonLocal?: CellValue[][];
Eigenschaftswert
Excel.CellValue[][]