Excel.ChartAxis class
Stellt eine einzelne Achse in einem Diagramm dar.
- Extends
Hinweise
Verwendet von
Eigenschaften
| alignment | Gibt die Ausrichtung für die angegebene Achsenteilstrichbeschriftung an. Weitere Informationen finden Sie hier |
| axis |
Gibt die Gruppe für die angegebene Achse an. Weitere Informationen findest du hier |
| base |
Gibt die Basiseinheit für die angegebene Kategorieachse an. |
| category |
Gibt den Kategorieachsentyp an. |
| context | Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden. |
| custom |
Gibt den Wert der benutzerdefinierten Anzeigeeinheit für die Achse an. Verwenden Sie zum Festlegen dieser Eigenschaft die |
| display |
Die Anzeigeeinheit für die Achse. Weitere Informationen findest du hier |
| format | Stellt die Formatierung für ein Diagrammobjekt dar, einschließlich Linien- und Schriftartformatierung. |
| height | Gibt die Höhe der Diagrammachse in Punkt an. Gibt zurück |
| is |
Gibt an, ob die Größenachse die Kategorieachse zwischen Kategorien kreuzt. |
| left | Gibt den Abstand in Punkt vom linken Rand der Achse bis links vom Diagrammbereich an. Gibt zurück |
| link |
Gibt an, ob das Zahlenformat mit den Zellen verknüpft ist. If |
| log |
Gibt die Basis des Logarithmus an, wenn logarithmische Skalen verwendet werden. |
| major |
Gibt ein Objekt zurück, das die Hauptgitternetzlinien für die angegebene Achse darstellt. |
| major |
Gibt den Typ des großen Teilstrichs für die angegebene Achse an. Weitere Informationen findest du hier |
| major |
Gibt den Skalierungswert für die Haupteinheit für die Rubrikenachse an, wenn die |
| major |
Stellt das Intervall zwischen zwei Hauptteilstrichen dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden. Der zurückgegebene Wert ist immer eine Zahl. |
| maximum | Stellt den Maximalwert auf der Größenachse dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden (für automatische Achsenwerte). Der zurückgegebene Wert ist immer eine Zahl. |
| minimum | Stellt den Mindestwert auf der Größenachse dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden (für automatische Achsenwerte). Der zurückgegebene Wert ist immer eine Zahl. |
| minor |
Gibt ein Objekt zurück, das die Nebengitternetzlinien für die angegebene Achse darstellt. |
| minor |
Gibt den Typ des kleinen Teilstrichs für die angegebene Achse an. Weitere Informationen findest du hier |
| minor |
Gibt den Wert für die untere Einheitskalierung für die Kategorieachse an, wenn die |
| minor |
Stellt das Intervall zwischen zwei Hilfsteilstrichen dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden (für automatische Achsenwerte). Der zurückgegebene Wert ist immer eine Zahl. |
| multi |
Gibt an, ob eine Achse mehrstufig ist. |
| number |
Gibt den Formatcode für die Beschriftung der Achsenteilstriche an. |
| offset | Gibt den Abstand zwischen den Beschriftungsebenen und den Abstand zwischen der ersten Ebene und der Achsenlinie an. Der Wert sollte eine ganze Zahl zwischen 0 und 1000 sein. |
| position | Gibt die angegebene Achsenposition an, an der sich die andere Achse kreuzt. Weitere Informationen findest du hier |
| position |
Gibt die Position an der Stelle an, an der sich die andere Achse kreuzt. Sie sollten die |
| reverse |
Gibt an, ob Excel Datenpunkte vom letzten zum ersten Mal darstellt. |
| scale |
Gibt den Skalierungstyp der Größenachse an. Weitere Informationen findest du hier |
| show |
Gibt an, ob die Beschriftung der Achsenanzeigeeinheit sichtbar ist. |
| text |
Gibt den Winkel an, in dem der Text für die Teilstrichbeschriftung der Diagrammachse ausgerichtet ist. Der Wert sollte entweder eine ganze Zahl zwischen -90 und 90 oder eine ganze Zahl 180 für vertikal ausgerichteten Text sein. |
| tick |
Gibt die Position der Teilstrichbeschriftungen der angegebenen Achse an. Weitere Informationen findest du hier |
| tick |
Gibt die Anzahl der Kategorien oder Reihen zwischen Teilstrichbeschriftungen an. Kann ein Wert zwischen 1 und 31999 oder eine leere Zeichenfolge sein, wenn automatisch festgelegt. Der zurückgegebene Wert ist immer eine Zahl. |
| tick |
Gibt die Anzahl der Kategorien oder Reihen zwischen den Teilstrichen an. |
| title | Stellt den Achsentitel dar. |
| top | Gibt den Abstand in Punkt vom oberen Rand der Achse bis zum oberen Rand der Diagrammfläche an. Gibt zurück |
| type | Gibt den Achsentyp an. Weitere Informationen findest du hier |
| visible | Gibt an, ob die Achse sichtbar ist. |
| width | Gibt die Breite der Diagrammachse in Punkt an. Gibt zurück |
Methoden
| load(options) | Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
| load(property |
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
| load(property |
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
| set(properties, options) | Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben. |
| set(properties) | Legt mehrere Eigenschaften für das Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt. |
| set |
Legt alle Kategorienamen für die angegebene Achse fest. |
| set |
Legt für die Anzeigeeinheit der Achse einen benutzerdefinierten Wert fest. |
| set |
Legt die angegebene Achsenposition an der Stelle fest, an der sich die andere Achse kreuzt. |
| toJSON() | Überschreibt die JavaScript-Methode |
Details zur Eigenschaft
alignment
Gibt die Ausrichtung für die angegebene Achsenteilstrichbeschriftung an. Weitere Informationen finden Sie hier Excel.ChartTextHorizontalAlignment .
alignment: Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right";Eigenschaftswert
Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right"
Hinweise
axisGroup
Gibt die Gruppe für die angegebene Achse an. Weitere Informationen findest du hier Excel.ChartAxisGroup .
readonly axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";Eigenschaftswert
Excel.ChartAxisGroup | "Primary" | "Secondary"
Hinweise
baseTimeUnit
Gibt die Basiseinheit für die angegebene Kategorieachse an.
baseTimeUnit: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";Eigenschaftswert
Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"
Hinweise
categoryType
Gibt den Kategorieachsentyp an.
categoryType: Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis";Eigenschaftswert
Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis"
Hinweise
context
Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
context: RequestContext;Eigenschaftswert
customDisplayUnit
Gibt den Wert der benutzerdefinierten Anzeigeeinheit für die Achse an. Verwenden Sie zum Festlegen dieser Eigenschaft die SetCustomDisplayUnit(double) Methode.
readonly customDisplayUnit: number;Eigenschaftswert
number
Hinweise
displayUnit
Die Anzeigeeinheit für die Achse. Weitere Informationen findest du hier Excel.ChartAxisDisplayUnit .
displayUnit: Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom";Eigenschaftswert
Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom"
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-axis.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
let chart = sheet.charts.getItemAt(0);
let categoryAxis = chart.axes.categoryAxis;
let valueAxis = chart.axes.valueAxis;
// Load to get display unit.
valueAxis.load("displayUnit");
await context.sync();
console.log("The vertical axis display unit is: " + valueAxis.displayUnit);
});
format
Stellt die Formatierung für ein Diagrammobjekt dar, einschließlich Linien- und Schriftartformatierung.
readonly format: Excel.ChartAxisFormat;Eigenschaftswert
Hinweise
height
Gibt die Höhe der Diagrammachse in Punkt an. Gibt zurück null , wenn die Achse nicht sichtbar ist.
readonly height: number;Eigenschaftswert
number
Hinweise
isBetweenCategories
Gibt an, ob die Größenachse die Kategorieachse zwischen Kategorien kreuzt.
isBetweenCategories: boolean;Eigenschaftswert
boolean
Hinweise
left
Gibt den Abstand in Punkt vom linken Rand der Achse bis links vom Diagrammbereich an. Gibt zurück null , wenn die Achse nicht sichtbar ist.
readonly left: number;Eigenschaftswert
number
Hinweise
linkNumberFormat
Gibt an, ob das Zahlenformat mit den Zellen verknüpft ist. If true, ändert sich das Zahlenformat in den Beschriftungen, wenn es sich in den Zellen ändert.
linkNumberFormat: boolean;Eigenschaftswert
boolean
Hinweise
logBase
Gibt die Basis des Logarithmus an, wenn logarithmische Skalen verwendet werden.
logBase: number;Eigenschaftswert
number
Hinweise
majorGridlines
Gibt ein Objekt zurück, das die Hauptgitternetzlinien für die angegebene Achse darstellt.
readonly majorGridlines: Excel.ChartGridlines;Eigenschaftswert
Hinweise
majorTickMark
Gibt den Typ des großen Teilstrichs für die angegebene Achse an. Weitere Informationen findest du hier Excel.ChartAxisTickMark .
majorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";Eigenschaftswert
Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"
Hinweise
majorTimeUnitScale
Gibt den Skalierungswert für die Haupteinheit für die Rubrikenachse an, wenn die categoryType Eigenschaft auf dateAxisfestgelegt ist.
majorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";Eigenschaftswert
Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"
Hinweise
majorUnit
Stellt das Intervall zwischen zwei Hauptteilstrichen dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden. Der zurückgegebene Wert ist immer eine Zahl.
majorUnit: any;Eigenschaftswert
any
Hinweise
maximum
Stellt den Maximalwert auf der Größenachse dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden (für automatische Achsenwerte). Der zurückgegebene Wert ist immer eine Zahl.
maximum: any;Eigenschaftswert
any
Hinweise
minimum
Stellt den Mindestwert auf der Größenachse dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden (für automatische Achsenwerte). Der zurückgegebene Wert ist immer eine Zahl.
minimum: any;Eigenschaftswert
any
Hinweise
minorGridlines
Gibt ein Objekt zurück, das die Nebengitternetzlinien für die angegebene Achse darstellt.
readonly minorGridlines: Excel.ChartGridlines;Eigenschaftswert
Hinweise
minorTickMark
Gibt den Typ des kleinen Teilstrichs für die angegebene Achse an. Weitere Informationen findest du hier Excel.ChartAxisTickMark .
minorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";Eigenschaftswert
Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"
Hinweise
minorTimeUnitScale
Gibt den Wert für die untere Einheitskalierung für die Kategorieachse an, wenn die categoryType Eigenschaft auf dateAxisgesetzt ist.
minorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";Eigenschaftswert
Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"
Hinweise
minorUnit
Stellt das Intervall zwischen zwei Hilfsteilstrichen dar. Kann auf einen numerischen Wert oder eine leere Zeichenfolge festgelegt werden (für automatische Achsenwerte). Der zurückgegebene Wert ist immer eine Zahl.
minorUnit: any;Eigenschaftswert
any
Hinweise
multiLevel
Gibt an, ob eine Achse mehrstufig ist.
multiLevel: boolean;Eigenschaftswert
boolean
Hinweise
numberFormat
Gibt den Formatcode für die Beschriftung der Achsenteilstriche an.
numberFormat: string;Eigenschaftswert
string
Hinweise
offset
Gibt den Abstand zwischen den Beschriftungsebenen und den Abstand zwischen der ersten Ebene und der Achsenlinie an. Der Wert sollte eine ganze Zahl zwischen 0 und 1000 sein.
offset: number;Eigenschaftswert
number
Hinweise
position
Gibt die angegebene Achsenposition an, an der sich die andere Achse kreuzt. Weitere Informationen findest du hier Excel.ChartAxisPosition .
position: Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom";Eigenschaftswert
Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom"
Hinweise
positionAt
Gibt die Position an der Stelle an, an der sich die andere Achse kreuzt. Sie sollten die SetPositionAt(double) Methode verwenden, um diese Eigenschaft festzulegen.
readonly positionAt: number;Eigenschaftswert
number
Hinweise
reversePlotOrder
Gibt an, ob Excel Datenpunkte vom letzten zum ersten Mal darstellt.
reversePlotOrder: boolean;Eigenschaftswert
boolean
Hinweise
scaleType
Gibt den Skalierungstyp der Größenachse an. Weitere Informationen findest du hier Excel.ChartAxisScaleType .
scaleType: Excel.ChartAxisScaleType | "Linear" | "Logarithmic";Eigenschaftswert
Excel.ChartAxisScaleType | "Linear" | "Logarithmic"
Hinweise
showDisplayUnitLabel
Gibt an, ob die Beschriftung der Achsenanzeigeeinheit sichtbar ist.
showDisplayUnitLabel: boolean;Eigenschaftswert
boolean
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-axis.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
let chart = sheet.charts.getItemAt(0);
let axis = chart.axes.valueAxis;
// Remove display unit.
axis.showDisplayUnitLabel = false;
await context.sync();
});
textOrientation
Gibt den Winkel an, in dem der Text für die Teilstrichbeschriftung der Diagrammachse ausgerichtet ist. Der Wert sollte entweder eine ganze Zahl zwischen -90 und 90 oder eine ganze Zahl 180 für vertikal ausgerichteten Text sein.
textOrientation: any;Eigenschaftswert
any
Hinweise
tickLabelPosition
Gibt die Position der Teilstrichbeschriftungen der angegebenen Achse an. Weitere Informationen findest du hier Excel.ChartAxisTickLabelPosition .
tickLabelPosition: Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None";Eigenschaftswert
Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None"
Hinweise
tickLabelSpacing
Gibt die Anzahl der Kategorien oder Reihen zwischen Teilstrichbeschriftungen an. Kann ein Wert zwischen 1 und 31999 oder eine leere Zeichenfolge sein, wenn automatisch festgelegt. Der zurückgegebene Wert ist immer eine Zahl.
tickLabelSpacing: any;Eigenschaftswert
any
Hinweise
tickMarkSpacing
Gibt die Anzahl der Kategorien oder Reihen zwischen den Teilstrichen an.
tickMarkSpacing: number;Eigenschaftswert
number
Hinweise
title
Stellt den Achsentitel dar.
readonly title: Excel.ChartAxisTitle;Eigenschaftswert
Hinweise
top
Gibt den Abstand in Punkt vom oberen Rand der Achse bis zum oberen Rand der Diagrammfläche an. Gibt zurück null , wenn die Achse nicht sichtbar ist.
readonly top: number;Eigenschaftswert
number
Hinweise
type
Gibt den Achsentyp an. Weitere Informationen findest du hier Excel.ChartAxisType .
readonly type: Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series";Eigenschaftswert
Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series"
Hinweise
visible
Gibt an, ob die Achse sichtbar ist.
visible: boolean;Eigenschaftswert
boolean
Hinweise
width
Gibt die Breite der Diagrammachse in Punkt an. Gibt zurück null , wenn die Achse nicht sichtbar ist.
readonly width: number;Eigenschaftswert
number
Hinweise
Details zur Methode
load(options)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(options?: Excel.Interfaces.ChartAxisLoadOptions): Excel.ChartAxis;Parameter
Stellt Optionen für die zu ladenden Eigenschaften des Objekts bereit.
Gibt zurück
load(propertyNames)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNames?: string | string[]): Excel.ChartAxis;Parameter
- propertyNames
-
string | string[]
Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.
Gibt zurück
Beispiele
// Get the maximum of Chart Axis from Chart1.
await Excel.run(async (context) => {
const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
const axis = chart.axes.valueAxis;
axis.load('maximum');
await context.sync();
console.log(axis.maximum);
});
load(propertyNamesAndPaths)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.ChartAxis;Parameter
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select ist eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.
Gibt zurück
set(properties, options)
Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.
set(properties: Interfaces.ChartAxisUpdateData, options?: OfficeExtension.UpdateOptions): void;Parameter
- properties
- Excel.Interfaces.ChartAxisUpdateData
Ein JavaScript-Objekt mit Eigenschaften, die isomorph zu den Eigenschaften des Objekts strukturiert sind, für das die Methode aufgerufen wird.
- options
- OfficeExtension.UpdateOptions
Bietet eine Option zum Unterdrücken von Fehlern, wenn das properties-Objekt versucht, schreibgeschützte Eigenschaften festzulegen.
Gibt zurück
void
set(properties)
Legt mehrere Eigenschaften für das Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.
set(properties: Excel.ChartAxis): void;Parameter
- properties
- Excel.ChartAxis
Gibt zurück
void
setCategoryNames(sourceData)
Legt alle Kategorienamen für die angegebene Achse fest.
setCategoryNames(sourceData: Range): void;Parameter
- sourceData
- Excel.Range
Das Range Objekt, das den Quelldaten entspricht.
Gibt zurück
void
Hinweise
setCustomDisplayUnit(value)
Legt für die Anzeigeeinheit der Achse einen benutzerdefinierten Wert fest.
setCustomDisplayUnit(value: number): void;Parameter
- value
-
number
Benutzerdefinierter Wert der Anzeigeeinheit.
Gibt zurück
void
Hinweise
setPositionAt(value)
Legt die angegebene Achsenposition an der Stelle fest, an der sich die andere Achse kreuzt.
setPositionAt(value: number): void;Parameter
- value
-
number
Benutzerdefinierter Wert des Kreuzungspunkts.
Gibt zurück
void
Hinweise
toJSON()
Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche Excel.ChartAxis Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.ChartAxisData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.
toJSON(): Excel.Interfaces.ChartAxisData;