Excel.Interfaces.RangeLoadOptions interface
Der Bereich stellt eine Gruppe von einer oder mehreren zusammenhängenden Zellen dar, z. B. eine Zelle, eine Zeile, eine Spalte oder einen Block von Zellen. Weitere Informationen zur Verwendung von Bereichen in der API finden Sie unter "Bereiche" in der Excel-JavaScript-API.
Eigenschaften
| $all | Wenn Sie für die Ladeoptionen angeben |
| address | Gibt den Bereichsbezug im A1-Format an. Der Adresswert enthält den Blattbezug (z. B. "Tabelle1! A1:B4"). |
| address |
Stellt den Bereichsbezug für den angegebenen Bereich in der Sprache des Benutzers dar. |
| cell |
Gibt die Anzahl der Zellen im Bereich an. Diese API gibt -1 zurück, wenn die Zellenanzahl 2^31-1 (2.147.483.647) überschreitet. |
| column |
Gibt die Gesamtanzahl der Spalten im Bereich an. |
| column |
Gibt an, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Wert ist |
| column |
Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert. |
| format | Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt. |
| 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. |
| hidden | Gibt an, ob alle Zellen im aktuellen Bereich ausgeblendet sind. Wert ist |
| number |
Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes. |
| row |
Gibt die Anzahl der Zeilen im Bereich zurück. |
| row |
Gibt an, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Wert ist |
| row |
Gibt die Spaltenanzahl der ersten Zelle im Bereich zurück. Nullindiziert. |
| text | Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Das Ersetzen des Nummernzeichens (#) in der Excel-Benutzeroberfläche wirkt sich nicht auf den von der API zurückgegebenen Textwert aus. |
| 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. |
| value |
Gibt den Datentyp in jeder Zelle an. |
| worksheet | Das Arbeitsblatt, das den aktuellen Bereich enthält. |
Details zur Eigenschaft
$all
Wenn Sie für die Ladeoptionen angeben $all , werden alle skalaren Eigenschaften (z. B Range.address. ) geladen, aber nicht die Navigationseigenschaften (z. B Range.format.fill.color. ).
$all?: boolean;
Eigenschaftswert
boolean
address
Gibt den Bereichsbezug im A1-Format an. Der Adresswert enthält den Blattbezug (z. B. "Tabelle1! A1:B4").
address?: boolean;
Eigenschaftswert
boolean
Hinweise
addressLocal
Stellt den Bereichsbezug für den angegebenen Bereich in der Sprache des Benutzers dar.
addressLocal?: boolean;
Eigenschaftswert
boolean
Hinweise
cellCount
Gibt die Anzahl der Zellen im Bereich an. Diese API gibt -1 zurück, wenn die Zellenanzahl 2^31-1 (2.147.483.647) überschreitet.
cellCount?: boolean;
Eigenschaftswert
boolean
Hinweise
columnCount
Gibt die Gesamtanzahl der Spalten im Bereich an.
columnCount?: boolean;
Eigenschaftswert
boolean
Hinweise
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
columnIndex
Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert.
columnIndex?: boolean;
Eigenschaftswert
boolean
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.RangeFormatLoadOptions;
Eigenschaftswert
Hinweise
formulas
Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulas?: boolean;
Eigenschaftswert
boolean
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?: boolean;
Eigenschaftswert
boolean
Hinweise
formulasR1C1
Stellt die Formel in der R1C1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasR1C1?: boolean;
Eigenschaftswert
boolean
Hinweise
hidden
Gibt an, ob alle Zellen im aktuellen Bereich ausgeblendet sind. Wert ist true , wenn alle Zellen in einem Bereich ausgeblendet sind. Wert ist false , wenn keine Zellen im Bereich ausgeblendet sind. Wert ist null , wenn einige Zellen in einem Bereich ausgeblendet sind und andere Zellen im selben Bereich nicht ausgeblendet sind.
hidden?: boolean;
Eigenschaftswert
boolean
Hinweise
numberFormat
Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.
numberFormat?: boolean;
Eigenschaftswert
boolean
Hinweise
rowCount
Gibt die Anzahl der Zeilen im Bereich zurück.
rowCount?: boolean;
Eigenschaftswert
boolean
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
rowIndex
Gibt die Spaltenanzahl der ersten Zelle im Bereich zurück. Nullindiziert.
rowIndex?: boolean;
Eigenschaftswert
boolean
Hinweise
text
Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Das Ersetzen des Nummernzeichens (#) in der Excel-Benutzeroberfläche wirkt sich nicht auf den von der API zurückgegebenen Textwert aus.
text?: boolean;
Eigenschaftswert
boolean
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?: boolean;
Eigenschaftswert
boolean
Hinweise
valueTypes
Gibt den Datentyp in jeder Zelle an.
valueTypes?: boolean;
Eigenschaftswert
boolean
Hinweise
worksheet
Das Arbeitsblatt, das den aktuellen Bereich enthält.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;