PowerPoint.PictureAddOptions interface
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.
Stellt die verfügbaren Optionen beim Hinzufügen eines Bilds dar (dargestellt durch ein PowerPoint.Shape-Objekt ).
Hinweise
API-Satz: PowerPointApi BETA (NUR VORSCHAU)
Verwendet von
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/preview-apis/add-picture.yaml
// Insert a picture on the current slide.
await PowerPoint.run(async (context) => {
const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
// Use PictureAddOptions to control the position and dimensions (in points).
const options: PowerPoint.PictureAddOptions = {
left: 100,
top: 100,
width: 250,
height: 180,
};
const picture: PowerPoint.Shape = slide.shapes.addPicture(getSampleImageBase64(), options);
picture.name = "SamplePicture";
// Set accessibility properties on the inserted picture.
picture.altTextTitle = "Sample image";
picture.altTextDescription = "A cartoon dog image used as a sample picture in this add-in.";
await context.sync();
});
Eigenschaften
| height | Gibt die Höhe des Bilds in Punkt an. Wenn nicht angegeben, beträgt der Standardwert 72 Punkt (1 Zoll). Löst eine |
| left | Gibt den Abstand in Punkt von der linken Seite des Bilds zur linken Seite der Folie an. Wenn nicht angegeben, ist der Standardwert 0. |
| top | Gibt den Abstand vom oberen Rand des Bilds bis zum oberen Rand der Folie in Punkt an. Wenn nicht angegeben, ist der Standardwert 0. |
| width | Gibt die Breite des Bilds in Punkt an. Wenn nicht angegeben, beträgt der Standardwert 72 Punkt (1 Zoll). Löst eine |
Details zur Eigenschaft
height
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.
Gibt die Höhe des Bilds in Punkt an. Wenn nicht angegeben, beträgt der Standardwert 72 Punkt (1 Zoll). Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.
height?: number;Eigenschaftswert
number
Hinweise
left
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.
Gibt den Abstand in Punkt von der linken Seite des Bilds zur linken Seite der Folie an. Wenn nicht angegeben, ist der Standardwert 0.
left?: number;Eigenschaftswert
number
Hinweise
top
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.
Gibt den Abstand vom oberen Rand des Bilds bis zum oberen Rand der Folie in Punkt an. Wenn nicht angegeben, ist der Standardwert 0.
top?: number;Eigenschaftswert
number
Hinweise
width
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.
Gibt die Breite des Bilds in Punkt an. Wenn nicht angegeben, beträgt der Standardwert 72 Punkt (1 Zoll). Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.
width?: number;Eigenschaftswert
number