Excel. Chart Axis class

axisGroup

Gibt die Gruppe für die angegebene Achse an. Weitere Informationen finden Sie unter 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 Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Excel.RequestContext

customDisplayUnit

Gibt den Benutzerdefinierten Achsenanzeigeeinheitswert an. Verwenden Sie die SetCustomDisplayUnit(double) -Methode, um diese Eigenschaft festzulegen.

readonly customDisplayUnit: number;

Eigenschaftswert

number

Hinweise

displayUnit

Die Anzeigeeinheit für die Achse. Weitere Informationen finden Sie unter Excel.ChartAxisDisplayUnit .

displayUnit: Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom";

Eigenschaftswert

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

Excel.ChartAxisFormat

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 zur linken Seite der Diagrammfläche 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. Gibt truean, dass sich das Zahlenformat in den Bezeichnungen ändert, wenn es sich in den Zellen ändert.

linkNumberFormat: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

logBase

Gibt die Basis des Logarithmus an, wenn logarithmische Skalierungen 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

Excel.ChartGridlines

Hinweise

majorTickMark

Gibt den Typ des Hauptteilstrichs für die angegebene Achse an. Weitere Informationen finden Sie unter Excel.ChartAxisTickMark .

majorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";

Eigenschaftswert

Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"

Hinweise

majorTimeUnitScale

Gibt den Skalierungswert der Haupteinheit für die Kategorieachse 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

Excel.ChartGridlines

Hinweise

minorTickMark

Gibt den Typ des Teilstrichs für die angegebene Achse an. Weitere Informationen finden Sie unter Excel.ChartAxisTickMark .

minorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";

Eigenschaftswert

Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"

Hinweise

minorTimeUnitScale

Gibt den Skalierungswert für kleinere Einheiten für die Kategorieachse an, wenn die categoryType -Eigenschaft auf dateAxisfestgelegt 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 mehrere Ebenen hat.

multiLevel: boolean;

Eigenschaftswert

boolean

Hinweise

numberFormat

Gibt den Formatcode für die Achsenstrichbeschriftung an.

numberFormat: string;

Eigenschaftswert

string

Hinweise

offset

Gibt den Abstand zwischen den Ebenen von Bezeichnungen 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 finden Sie unter Excel.ChartAxisPosition .

position: Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom";

Eigenschaftswert

Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom"

Hinweise

positionAt

Gibt die Achsenposition 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 bis zum ersten gezeichnet.

reversePlotOrder: boolean;

Eigenschaftswert

boolean

Hinweise

scaleType

Gibt den Größenachsenskalierungstyp an. Weitere Informationen finden Sie unter Excel.ChartAxisScaleType .

scaleType: Excel.ChartAxisScaleType | "Linear" | "Logarithmic";

Eigenschaftswert

Excel.ChartAxisScaleType | "Linear" | "Logarithmic"

Hinweise

showDisplayUnitLabel

Gibt an, ob die Bezeichnung 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, an dem der Text für die Teilstrichbezeichnung der Diagrammachse ausgerichtet ist. Der Wert sollte entweder eine ganze Zahl von -90 bis 90 oder die 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 finden Sie unter Excel.ChartAxisTickLabelPosition .

tickLabelPosition: Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None";

Eigenschaftswert

Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None"

Hinweise

tickLabelSpacing

Gibt die Anzahl von 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 von Kategorien oder Reihen zwischen Teilstrichen an.

tickMarkSpacing: number;

Eigenschaftswert

number

Hinweise

title

Stellt den Achsentitel dar.

readonly title: Excel.ChartAxisTitle;

Eigenschaftswert

Excel.ChartAxisTitle

Hinweise

top

Gibt den Abstand in Punkt vom oberen Rand der Achse bis zum oberen Rand des Diagrammbereichs an. Gibt zurück null , wenn die Achse nicht sichtbar ist.

readonly top: number;

Eigenschaftswert

number

Hinweise

type

Gibt den Achsentyp an. Weitere Informationen finden Sie unter 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

options: Excel.Interfaces.ChartAxisLoadOptions

Stellt Optionen dafür bereit, welche Eigenschaften des -Objekts geladen werden sollen.

Gibt zurück

Excel.ChartAxis

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

Excel.ChartAxis

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 Trennzeichen getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.

Gibt zurück

Excel.ChartAxis

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

Stellt eine Option zum Unterdrücken von Fehlern bereit, wenn das Eigenschaftenobjekt 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 fest, an der sich die andere Achse kreuzt.

setPositionAt(value: number): void;

Parameter

value: number

Benutzerdefinierter Wert des Kreuzungspunkts.

Gibt zurück

void

Hinweise