Teilen über


PowerPoint-JavaScript-Vorschau-APIs

Neue PowerPoint-JavaScript-APIs werden zuerst in der "Vorschau" eingeführt und später Teil eines bestimmten, nummerierten Anforderungssatzes, nachdem genügend Tests durchgeführt und Benutzerfeedback eingeholt wurde.

Hinweis

Vorschau-APIs unterliegen Änderungen und können nicht für den Einsatz in Produktionsumgebungen vorgesehen werden. Wir empfehlen, sie nur in Test- und Entwicklungsumgebungen auszuprobieren. Verwenden Sie Vorschau-APIs nicht in einer Produktionsumgebung oder in unternehmenswichtigen Dokumenten.

So verwenden Sie Vorschau-APIs:

  • Sie müssen die Vorschauversion der Office JavaScript-API-Bibliothek aus dem Office.js Content Delivery Network (CDN) verwenden. Die Typdefinitionsdatei für die TypeScript-Kompilierung und IntelliSense finden Sie unter CDN und DefinitelyTyped. Sie können diese Typen mit npm install --save-dev @types/office-js-preview installieren (achten Sie darauf, die Typen für @types/office-js zu entfernen, wenn Sie sie zuvor installiert haben).
  • Möglicherweise müssen Sie am Microsoft 365 Insider-Programm teilnehmen, um Zugriff auf neuere Office-Builds zu erhalten.

API-Liste

In der folgenden Tabelle sind die PowerPoint-JavaScript-APIs aufgeführt, die sich derzeit in der Vorschauphase befinden. Eine vollständige Liste aller PowerPoint-JavaScript-APIs (einschließlich Vorschau-APIs und zuvor veröffentlichter APIs) finden Sie unter Alle PowerPoint JavaScript-APIs.

Klasse Felder Beschreibung
Adjustments count Gibt die Anzahl der Anpassungspunkte an.
get(index: number) Ruft den Anpassungswert am angegebenen nullbasierten Index ab.
BulletFormat style Gibt die Formatvorlage der Aufzählungszeichen im Absatz an.
type Gibt den Typ der Aufzählungszeichen im Absatz an.
CustomPropertyCollection getItemAt(index: number) Ruft einen CustomProperty nach seinem nullbasierten Index in der Auflistung ab.
CustomXmlPartCollection getItemAt(index: number) Ruft einen CustomXmlPart nach seinem nullbasierten Index in der Auflistung ab.
CustomXmlPartScopedCollection getItemAt(index: number) Ruft einen CustomXmlPart nach seinem nullbasierten Index in der Auflistung ab.
Hyperlink delete() Löscht den Link.
getLinkedShapeOrNullObject() Gibt das PowerPoint.Shape-Objekt zurück, auf das der Link angewendet wird.
getLinkedTextRangeOrNullObject() Gibt das PowerPoint.TextRange-Objekt zurück, auf das der Link angewendet wird.
type Gibt den Typ des Objekts zurück, auf das der Link angewendet wird.
HyperlinkAddOptions address Gibt die Adresse des Links an, bei der es sich um eine URL, einen Dateinamen oder Dateipfad oder eine E-Mail-Adresse mit dem mailto URI-Schema handeln kann.
QuickInfo Gibt die Zeichenfolge an, die beim Zeigen auf den Link angezeigt wird.
HyperlinkCollection add(target: TextRange | Form, Optionen?: PowerPoint.HyperlinkAddOptions) Fügt dem angegebenen Ziel einen Link mit den angegebenen Optionen hinzu.
HyperlinkScopedCollection getCount() Ruft die Anzahl der Hyperlinks in der Auflistung ab.
getItemAt(index: number) Ruft einen Link mithilfe seines nullbasierten Indexes in der Auflistung ab.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
PageSetup slideHeight Gibt die Höhe der Folien in der Präsentation in Punkt an.
slideWidth Gibt die Breite der Folien in der Präsentation in Punkt an.
ParagraphFormat indentLevel Stellt die Einzugsebene des Absatzes dar.
Presentation getActiveSlideOrNullObject() Gibt die aktuell aktive PowerPoint.Slide zurück, die im Bearbeitungsbereich sichtbar ist.
pageSetup Gibt die Informationen zum Einrichten der Seite zurück, deren Eigenschaften die Attribute für die Folieneinrichtung für die Präsentation steuern.
Shape Anpassungen Gibt ein Adjustments Objekt zurück, das Anpassungswerte für alle Anpassungen in dieser Form enthält.
altTextDescription Die Alternativtextbeschreibung der Form.
altTextTitle Der Alternativtexttitel des Shapes.
creationId Ruft die Erstellungs-ID des Shapes ab.
getImageAsBase64(options?: PowerPoint.ShapeGetImageOptions) Rendert ein Bild der Form.
getTextFrameOrNullObject() Gibt das PowerPoint.TextFrame-Objekt dieses Shapezurück.
isDecorative Gibt an, ob die Form dekorativ ist oder nicht.
rotation Gibt die Drehung der Form um die Z-Achse in Grad an.
setHyperlink(options?: PowerPoint.HyperlinkAddOptions) Legt einen Link für diesen Shape mit den angegebenen Optionen fest.
visible Gibt an, ob die Form sichtbar ist.
ShapeGetImageOptions format Das gewünschte Format des resultierenden Bilds.
height Die gewünschte Höhe des resultierenden Bilds in Pixel.
width Die gewünschte Breite des resultierenden Bilds in Pixel.
ShapeGroup creationId Ruft die Erstellungs-ID der Shape-Gruppe ab.
Slide Hintergrund Ruft den Hintergrund der Folie ab.
themeColorScheme Gibt die der ThemeColorScheme Folie zurück.
SlideBackground areBackgroundGraphicsHidden Gibt an, ob die Hintergrundfüllung des Folienlayouts Hintergrundgrafikobjekte aus der Folie master ausblendet oder anzeigt.
fill Gibt die Füllformatierung des Hintergrunds zurück.
isMasterBackgroundFollowed Gibt an, ob der Folienhintergrund der Folie master Hintergrund folgt.
reset() Setzt die Füllformatierung des Folienhintergrunds zurück.
SlideBackgroundFill getGradientFillOrNullObject() Ruft die Farbverlaufsfülleigenschaften ab.
getPatternFillOrNullObject() Ruft die Musterfülleigenschaften ab.
getPictureOrTextureFillOrNullObject() Ruft die Bild- oder Texturfülleigenschaften ab.
getSolidFillOrNullObject() Ruft die Volltonfülleigenschaften ab.
setGradientFill(options?: PowerPoint.SlideBackgroundGradientFillOptions) Legt die Füllformatierung des Folienhintergrunds auf eine Farbverlaufsfüllung fest.
setPatternFill(options?: PowerPoint.SlideBackgroundPatternFillOptions) Legt die Füllformatierung des Folienhintergrunds auf eine Musterfüllung fest.
setPictureOrTextureFill(options?: PowerPoint.SlideBackgroundPictureOrTextureFillOptions) Legt die Füllformatierung des Folienhintergrunds auf ein Bild oder eine Texturfüllung fest.
setSolidFill(options?: PowerPoint.SlideBackgroundSolidFillOptions) Legt die Füllformatierung des Folienhintergrunds auf eine Volltonfüllung fest.
type Gibt den Fülltyp des Folienhintergrunds zurück.
SlideBackgroundGradientFill type Gibt den Typ von gradient fill an.
SlideBackgroundGradientFillOptions type Gibt den Typ der Farbverlaufsfüllung an, sofern angegeben.
SlideBackgroundPatternFill backgroundColor Gibt die Hintergrundfarbe im HTML-Farbformat an (z. B. "#FFFFFF" oder "weiß").
foregroundColor Gibt die Vordergrundfarbe im HTML-Farbformat an (z. B. "#FFA500" oder "orange").
pattern Gibt den Mustertyp an.
SlideBackgroundPatternFillOptions backgroundColor Wenn angegeben, gibt die Hintergrundfarbe im HTML-Farbformat an (z. B. "#FFFFFF" oder "weiß").
foregroundColor Wenn angegeben, gibt die Vordergrundfarbe im HTML-Farbformat an (z. B. "#FFA500" oder "orange").
pattern Gibt den Mustertyp an, sofern angegeben.
SlideBackgroundPictureOrTextureFill setImage(base64EncodedImage: string) Legt das bild fest, das zum Füllen verwendet wird.
transparency Gibt den Transparenzprozentsatz der Füllung als Wert von 0,0 (undurchsichtig) bis 1,0 (klar) an.
SlideBackgroundPictureOrTextureFillOptions imageBase64 Wenn angegeben, gibt die Base64-codierten Bilddaten für die Füllung an.
transparency Wenn angegeben, gibt den Transparenzprozentsatz der Füllung als Wert von 0,0 (undurchsichtig) bis 1,0 (klar) an.
SlideBackgroundSolidFill color Gibt die Füllfarbe im HTML-Farbformat an (z. B. "#FFA500" oder "orange").
transparency Gibt den Transparenzprozentsatz der Füllung als Wert von 0,0 (undurchsichtig) bis 1,0 (klar) an.
SlideBackgroundSolidFillOptions color Wenn angegeben, gibt die Füllfarbe im HTML-Farbformat an (z. B. "#FFA500" oder "orange").
transparency Wenn angegeben, gibt den Transparenzprozentsatz der Füllung als Wert von 0,0 (undurchsichtig) bis 1,0 (klar) an.
SlideCollection exportAsBase64Presentation(values: Array<string | Folie>) Exportiert eine oder mehrere Folien in dieser Auflistung in eine eigene Präsentationsdatei, die als Base64-codierte Daten zurückgegeben wird.
SlideLayout Hintergrund Ruft den Hintergrund des Folienlayouts ab.
themeColorScheme Gibt den des ThemeColorScheme Folienlayouts zurück.
SlideLayoutBackground areBackgroundGraphicsHidden Gibt an, ob die Hintergrundfüllung des Folienlayouts Hintergrundgrafikobjekte aus der Folie master ausblendet oder anzeigt.
fill Gibt die Füllformatierung des Hintergrunds zurück.
isMasterBackgroundFollowed Gibt an, ob der Folienlayouthintergrund der Folie master Hintergrund folgt.
reset() Setzt die Füllformatierung des Folienlayouthintergrunds zurück.
SlideMaster Hintergrund Ruft den Hintergrund des Folienmasters ab.
themeColorScheme Gibt den ThemeColorScheme des Folienmasters zurück.
SlideMasterBackground fill Gibt die Füllformatierung des Hintergrunds zurück.
SlideScopedCollection exportAsBase64Presentation() Exportiert alle Folien in dieser Auflistung in eine eigene Präsentationsdatei, die als Base64-codierte Daten zurückgegeben wird.
TextRange Links Gibt eine Auflistung von Links zurück, die in diesem TextRangevorhanden sind.
setHyperlink(options?: PowerPoint.HyperlinkAddOptions) Legt einen Link für diesen TextRange mit den angegebenen Optionen fest.
ThemeColorScheme getThemeColor(color: PowerPoint.ThemeColor) Ruft den Farbwert für die angegebene ThemeColorab.
setThemeColor(color: PowerPoint.ThemeColor, rgbColor: string) Legt den Farbwert für die angegebene ThemeColorfest.

Siehe auch