Excel.Interfaces.RangeCollectionLoadOptions interface
Hinweise
Eigenschaften
$all | Wenn Sie |
address | Für JEDES ELEMENT in der Auflistung: Gibt den Bereichsverweis im A1-Stil an. Der Adresswert enthält den Blattverweis (z. B. "Sheet1! A1:B4"). |
address |
Für JEDES ELEMENT in der Auflistung: Stellt den Bereichsverweis für den angegebenen Bereich in der Sprache des Benutzers dar. |
cell |
Für JEDES ELEMENT in der Auflistung: 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 |
Für JEDES ELEMENT in der Auflistung: Gibt die Gesamtanzahl der Spalten im Bereich an. |
column |
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Der Wert ist |
column |
Für JEDES ELEMENT in der Auflistung: Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert. |
control | Für JEDES ELEMENT in der Auflistung: Greift auf das Zellsteuerelement zu, das auf diesen Bereich angewendet wird. Wenn der Bereich über mehrere Zellsteuerelemente verfügt, wird zurückgegeben |
data |
Für EACH ITEM in der Auflistung: Gibt ein Datenüberprüfungsobjekt zurück. |
format | Für EACH ITEM in der Auflistung: Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen, Ausrichtung und andere Eigenschaften des Bereichs kapselt. |
formulas | Für JEDES ELEMENT in der Auflistung: Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben. |
formulas |
Für JEDES ELEMENT in der Auflistung: Stellt die Formel in A1-Notation in der Sprache und dem Gebietsschema für die Zahlenformatierung des Benutzers 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 | Für JEDES ELEMENT in der Auflistung: Stellt die Formel im R1C1-Format dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben. |
has |
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen über einen Überlaufrahmen verfügen. Gibt zurück |
height | Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Bereichs bis zum unteren Rand des Bereichs zurück. |
hidden | Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen im aktuellen Bereich ausgeblendet sind. Der Wert ist |
hyperlink | Für JEDES ELEMENT in der Auflistung: Stellt den Link für den aktuellen Bereich dar. |
is |
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Spalte ist. |
is |
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Zeile ist. |
left | Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Arbeitsblatts zum linken Rand des Bereichs zurück. |
linked |
Für JEDES ELEMENT in der Auflistung: Stellt den Datentypzustand jeder Zelle dar. |
number |
Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes. |
number |
Für JEDES ELEMENT in der Auflistung: Stellt die Kategorie des Zahlenformats jeder Zelle dar. |
number |
Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich basierend auf den Spracheinstellungen des Benutzers dar. Excel führt beim Abrufen oder Festlegen der |
row |
Für EACH ITEM in der Auflistung: Gibt die Gesamtzahl der Zeilen im Bereich zurück. |
row |
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Value ist |
row |
Für JEDES ELEMENT in der Auflistung: Gibt die Zeilennummer der ersten Zelle im Bereich zurück. Nullindiziert. |
saved |
Für JEDES ELEMENT in der Auflistung: Gibt an, ob alle Zellen als Arrayformel gespeichert würden. Gibt zurück |
style | Für JEDES ELEMENT in der Auflistung: Stellt die Formatvorlage des aktuellen Bereichs dar. Wenn die Formatvorlagen der Zellen inkonsistent sind, |
text | Für JEDES ELEMENT in der Auflistung: Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Die Ersetzung des Nummernzeichens (#), die in der Excel-Benutzeroberfläche erfolgt, wirkt sich nicht auf den von der API zurückgegebenen Textwert aus. |
top | Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Arbeitsblatts bis zum oberen Rand des Bereichs zurück. |
values | Für JEDES ELEMENT in der Auflistung: Stellt die Rohwerte des angegebenen Bereichs dar. Bei den zurückgegebenen Daten kann es sich um eine Zeichenfolge, eine Zahl oder einen booleschen Wert handeln. Zellen, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück. Wenn der zurückgegebene Wert mit einem Pluszeichen ("+"), minus ("-") oder Gleichheitszeichen ("=") beginnt, interpretiert Excel diesen Wert als Formel. |
values |
Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu |
values |
Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu |
value |
Für JEDES ELEMENT in der Auflistung: Gibt den Datentyp in jeder Zelle an. |
width | Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Bereichs bis zum rechten Rand des Bereichs zurück. |
worksheet | Für JEDES ELEMENT in der Auflistung: Das Arbeitsblatt, das den aktuellen Bereich enthält. |
Details zur Eigenschaft
$all
Wenn Sie $all
für die Ladeoptionen angeben, werden alle skalaren Eigenschaften (zRange.address
. B. ) geladen, aber nicht die Navigationseigenschaften (zRange.format.fill.color
. B. ).
$all?: boolean;
Eigenschaftswert
boolean
address
Für JEDES ELEMENT in der Auflistung: Gibt den Bereichsverweis im A1-Stil an. Der Adresswert enthält den Blattverweis (z. B. "Sheet1! A1:B4").
address?: boolean;
Eigenschaftswert
boolean
Hinweise
addressLocal
Für JEDES ELEMENT in der Auflistung: Stellt den Bereichsverweis für den angegebenen Bereich in der Sprache des Benutzers dar.
addressLocal?: boolean;
Eigenschaftswert
boolean
Hinweise
cellCount
Für JEDES ELEMENT in der Auflistung: 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
Für JEDES ELEMENT in der Auflistung: Gibt die Gesamtanzahl der Spalten im Bereich an.
columnCount?: boolean;
Eigenschaftswert
boolean
Hinweise
columnHidden
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Der Wert ist true
, wenn alle Spalten in einem Bereich ausgeblendet sind. Der Wert ist false
, wenn keine Spalten im Bereich ausgeblendet werden. Der Wert ist null
, wenn einige Spalten in einem Bereich ausgeblendet sind und andere Spalten im gleichen Bereich nicht ausgeblendet werden.
columnHidden?: boolean;
Eigenschaftswert
boolean
Hinweise
columnIndex
Für JEDES ELEMENT in der Auflistung: Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert.
columnIndex?: boolean;
Eigenschaftswert
boolean
Hinweise
control
Hinweis
Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.
Für JEDES ELEMENT in der Auflistung: Greift auf das Zellsteuerelement zu, das auf diesen Bereich angewendet wird. Wenn der Bereich über mehrere Zellsteuerelemente verfügt, wird zurückgegeben EmptyCellControl
.
control?: boolean;
Eigenschaftswert
boolean
Hinweise
dataValidation
Für EACH ITEM in der Auflistung: Gibt ein Datenüberprüfungsobjekt zurück.
dataValidation?: Excel.Interfaces.DataValidationLoadOptions;
Eigenschaftswert
Hinweise
format
Für EACH ITEM in der Auflistung: Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen, Ausrichtung und andere Eigenschaften des Bereichs kapselt.
format?: Excel.Interfaces.RangeFormatLoadOptions;
Eigenschaftswert
Hinweise
formulas
Für JEDES ELEMENT in der Auflistung: 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
Für JEDES ELEMENT in der Auflistung: Stellt die Formel in A1-Notation in der Sprache und dem Gebietsschema für die Zahlenformatierung des Benutzers 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
Für JEDES ELEMENT in der Auflistung: Stellt die Formel im R1C1-Format dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasR1C1?: boolean;
Eigenschaftswert
boolean
Hinweise
hasSpill
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen über einen Überlaufrahmen verfügen. Gibt zurück true
, wenn alle Zellen einen Überlaufrahmen haben oder false
wenn alle Zellen keinen Überlaufrahmen haben. Gibt zurück null
, wenn sich Zellen mit und ohne Überlaufrahmen innerhalb des Bereichs befinden.
hasSpill?: boolean;
Eigenschaftswert
boolean
Hinweise
height
Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Bereichs bis zum unteren Rand des Bereichs zurück.
height?: boolean;
Eigenschaftswert
boolean
Hinweise
hidden
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen im aktuellen Bereich ausgeblendet sind. Der Wert ist true
, wenn alle Zellen in einem Bereich ausgeblendet sind. Der Wert ist false
, wenn keine Zellen im Bereich ausgeblendet werden. Wert ist null
, wenn einige Zellen in einem Bereich ausgeblendet sind und andere Zellen im gleichen Bereich nicht ausgeblendet werden.
hidden?: boolean;
Eigenschaftswert
boolean
Hinweise
hyperlink
Für JEDES ELEMENT in der Auflistung: Stellt den Link für den aktuellen Bereich dar.
hyperlink?: boolean;
Eigenschaftswert
boolean
Hinweise
isEntireColumn
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Spalte ist.
isEntireColumn?: boolean;
Eigenschaftswert
boolean
Hinweise
isEntireRow
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Zeile ist.
isEntireRow?: boolean;
Eigenschaftswert
boolean
Hinweise
left
Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Arbeitsblatts zum linken Rand des Bereichs zurück.
left?: boolean;
Eigenschaftswert
boolean
Hinweise
linkedDataTypeState
Für JEDES ELEMENT in der Auflistung: Stellt den Datentypzustand jeder Zelle dar.
linkedDataTypeState?: boolean;
Eigenschaftswert
boolean
Hinweise
numberFormat
Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.
numberFormat?: boolean;
Eigenschaftswert
boolean
Hinweise
numberFormatCategories
Für JEDES ELEMENT in der Auflistung: Stellt die Kategorie des Zahlenformats jeder Zelle dar.
numberFormatCategories?: boolean;
Eigenschaftswert
boolean
Hinweise
numberFormatLocal
Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich basierend auf den Spracheinstellungen des Benutzers dar. Excel führt beim Abrufen oder Festlegen der numberFormatLocal
Eigenschaft keine Sprach- oder Formatkoersion aus. Jeder zurückgegebene Text verwendet die lokal formatierten Zeichenfolgen basierend auf der in den Systemeinstellungen angegebenen Sprache.
numberFormatLocal?: boolean;
Eigenschaftswert
boolean
Hinweise
rowCount
Für EACH ITEM in der Auflistung: Gibt die Gesamtzahl der Zeilen im Bereich zurück.
rowCount?: boolean;
Eigenschaftswert
boolean
Hinweise
rowHidden
Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Value ist true
, wenn alle Zeilen in einem Bereich ausgeblendet sind. Der Wert ist false
, wenn keine Zeilen im Bereich ausgeblendet werden. Der Wert ist null
, wenn einige Zeilen in einem Bereich ausgeblendet sind und andere Zeilen im gleichen Bereich nicht ausgeblendet werden.
rowHidden?: boolean;
Eigenschaftswert
boolean
Hinweise
rowIndex
Für JEDES ELEMENT in der Auflistung: Gibt die Zeilennummer der ersten Zelle im Bereich zurück. Nullindiziert.
rowIndex?: boolean;
Eigenschaftswert
boolean
Hinweise
savedAsArray
Für JEDES ELEMENT in der Auflistung: Gibt an, ob alle Zellen als Arrayformel gespeichert würden. Gibt zurück true
, wenn alle Zellen als Arrayformel gespeichert würden oder false
wenn nicht alle Zellen als Arrayformel gespeichert würden. Gibt zurück null
, wenn einige Zellen als Arrayformel gespeichert würden und andere nicht.
savedAsArray?: boolean;
Eigenschaftswert
boolean
Hinweise
style
Für JEDES ELEMENT in der Auflistung: 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
Enumeration darstellt.
style?: boolean;
Eigenschaftswert
boolean
Hinweise
text
Für JEDES ELEMENT in der Auflistung: Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Die Ersetzung des Nummernzeichens (#), die in der Excel-Benutzeroberfläche erfolgt, wirkt sich nicht auf den von der API zurückgegebenen Textwert aus.
text?: boolean;
Eigenschaftswert
boolean
Hinweise
top
Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Arbeitsblatts bis zum oberen Rand des Bereichs zurück.
top?: boolean;
Eigenschaftswert
boolean
Hinweise
values
Für JEDES ELEMENT in der Auflistung: Stellt die Rohwerte des angegebenen Bereichs dar. Bei den zurückgegebenen Daten kann es sich um eine Zeichenfolge, eine Zahl oder einen booleschen Wert handeln. Zellen, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück. Wenn der zurückgegebene Wert mit einem Pluszeichen ("+"), minus ("-") oder Gleichheitszeichen ("=") beginnt, interpretiert Excel diesen Wert als Formel.
values?: boolean;
Eigenschaftswert
boolean
Hinweise
valuesAsJson
Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu Range.values
unterstützt Range.valuesAsJson
alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie die booleschen Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten entsprechen immer dem Gebietsschema en-US. Verwenden Sie Range.valuesAsJsonLocal
, um Daten im Anzeigegebietsschema des Benutzers abzurufen.
valuesAsJson?: boolean;
Eigenschaftswert
boolean
Hinweise
valuesAsJsonLocal
Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu Range.values
unterstützt Range.valuesAsJsonLocal
alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie die booleschen Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten sind immer am Anzeigegebietsschema des Benutzers ausgerichtet. Um Daten unabhängig vom Gebietsschema abzurufen, verwenden Sie Range.valuesAsJson
.
valuesAsJsonLocal?: boolean;
Eigenschaftswert
boolean
Hinweise
valueTypes
Für JEDES ELEMENT in der Auflistung: Gibt den Datentyp in jeder Zelle an.
valueTypes?: boolean;
Eigenschaftswert
boolean
Hinweise
width
Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Bereichs bis zum rechten Rand des Bereichs zurück.
width?: boolean;
Eigenschaftswert
boolean
Hinweise
worksheet
Für JEDES ELEMENT in der Auflistung: Das Arbeitsblatt, das den aktuellen Bereich enthält.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;
Eigenschaftswert
Hinweise
Office Add-ins