Excel.Line class

Stellt die Länge der Pfeilspitze am Anfang der angegebenen Linie dar.

beginArrowheadLength: Excel.ArrowheadLength | "Short" | "Medium" | "Long";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt das Format der Pfeilspitze am Anfang der angegebenen Linie dar.

beginArrowheadStyle: Excel.ArrowheadStyle | "None" | "Triangle" | "Stealth" | "Diamond" | "Oval" | "Open";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt die Breite der Pfeilspitze am Anfang der angegebenen Linie dar.

beginArrowheadWidth: Excel.ArrowheadWidth | "Narrow" | "Medium" | "Wide";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt die Form dar, an die der Anfang der angegebenen Linie angefügt ist.

readonly beginConnectedShape: Excel.Shape;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt die Verbindungsseite dar, mit der der Anfang einer Verbindung verbunden ist. Gibt zurück null , wenn der Anfang der Linie an kein Shape angefügt ist.

readonly beginConnectedSite: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt den Verbindertyp für die Linie dar.

connectorType: Excel.ConnectorType | "Straight" | "Elbow" | "Curve";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Stellt die Länge der Pfeilspitze am Ende der angegebenen Linie dar.

endArrowheadLength: Excel.ArrowheadLength | "Short" | "Medium" | "Long";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt das Format der Pfeilspitze am Ende der angegebenen Linie dar.

endArrowheadStyle: Excel.ArrowheadStyle | "None" | "Triangle" | "Stealth" | "Diamond" | "Oval" | "Open";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt die Breite der Pfeilspitze am Ende der angegebenen Linie dar.

endArrowheadWidth: Excel.ArrowheadWidth | "Narrow" | "Medium" | "Wide";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt die Form dar, an die das Ende der angegebenen Linie angefügt ist.

readonly endConnectedShape: Excel.Shape;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt die Verbindungsseite dar, mit der das Ende einer Verbindung verbunden ist. Gibt zurück null , wenn das Zeilenende an kein Shape angefügt ist.

readonly endConnectedSite: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den Formbezeichner an.

readonly id: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt an, ob der Anfang der angegebenen Linie mit einem Shape verbunden ist.

readonly isBeginConnected: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt an, ob das Ende der angegebenen Linie mit einem Shape verbunden ist.

readonly isEndConnected: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt das Shape mit der Linie verbundene Objekt zurück.

readonly shape: Excel.Shape;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Fügt den Anfang der angegebenen Verbindung an eine angegebene Form an.

connectBeginShape(shape: Excel.Shape, connectionSite: number): void;

Parameter

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml

await Excel.run(async (context) => {
    const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
    const line = shapes.getItem("StraightLine").line;
    line.connectBeginShape(shapes.getItem("Left"), 2);
    line.connectEndShape(shapes.getItem("Right"), 0);
    await context.sync();
});

Fügt das Ende der angegebenen Verbindung an eine angegebene Form an.

connectEndShape(shape: Excel.Shape, connectionSite: number): void;

Parameter

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml

await Excel.run(async (context) => {
    const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
    const line = shapes.getItem("StraightLine").line;
    line.connectBeginShape(shapes.getItem("Left"), 2);
    line.connectEndShape(shapes.getItem("Right"), 0);
    await context.sync();
});

Löst den Anfang der angegebenen Verbindung von einer Form.

disconnectBeginShape(): void;

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml

await Excel.run(async (context) => {
    const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
    const line = shapes.getItem("StraightLine").line;
    line.disconnectBeginShape();
    line.disconnectEndShape();
    await context.sync();
});

Löst das Ende der angegebenen Verbindung von einer Form.

disconnectEndShape(): void;

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml

await Excel.run(async (context) => {
    const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
    const line = shapes.getItem("StraightLine").line;
    line.disconnectBeginShape();
    line.disconnectEndShape();
    await context.sync();
});

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.LineLoadOptions): Excel.Line;

Parameter

Gibt zurück

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.Line;

Parameter

Gibt zurück

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.Line;

Parameter

Gibt zurück

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.LineUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parameter

Gibt zurück

Legt mehrere Eigenschaften für das Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.

set(properties: Excel.Line): void;

Parameter

Gibt zurück

Ü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.Line Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.LineData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): Excel.Interfaces.LineData;

Gibt zurück