Freigeben über

PowerPoint.ShapeGetImageOptions interface

Paket:
powerpoint

Stellt die verfügbaren Optionen beim Abrufen eines Bilds einer Form dar. Das Bild wird so skaliert, dass es in die gewünschten Dimensionen passt. Wenn Breite und Höhe nicht angegeben werden, wird die tatsächliche Größe der Form verwendet. Wenn nur eine breite oder höhe angegeben ist, wird die andere berechnet, um das Seitenverhältnis beizubehalten. Die resultierenden Abmessungen werden automatisch auf die maximal unterstützte Größe geklemmt, wenn sie zu groß sind.

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/get-shape-as-image.yaml

// Gets an image of the first selected shape with all options specified:
// a fixed width, height, and explicit PNG format.
await PowerPoint.run(async (context) => {
  const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
  const shapeCount = shapes.getCount();
  await context.sync();

  if (shapeCount.value === 0) {
    console.warn("No shapes are selected. Please select a shape and try again.");
    return;
  }

  const shape: PowerPoint.Shape = shapes.getItemAt(0);
  const options: PowerPoint.ShapeGetImageOptions = {
    format: PowerPoint.ShapeGetImageFormatType.png,
    width: 300,
    height: 150,
    // Both width and height are specified, so the image is scaled to fit within
    // 300x150 pixels. The image may not fill both dimensions if the aspect ratios differ.
  };
  const imageResult: OfficeExtension.ClientResult<string> = shape.getImageAsBase64(options);
  await context.sync();

  displayImage(imageResult.value, "PNG, 300x150px");
});

Eigenschaften

format

Das gewünschte Format des resultierenden Bilds.
height

Die gewünschte Höhe des resultierenden Bilds in Pixel. Dieser Wert wird automatisch auf die maximal unterstützte Größe geklemmt, wenn er zu groß ist. Löst eine Ausnahme aus InvalidArgument , wenn eine nicht positive ganze Zahl festgelegt wird.
width

Die gewünschte Breite des resultierenden Bilds in Pixel. Dieser Wert wird automatisch auf die maximal unterstützte Größe geklemmt, wenn er zu groß ist. Löst eine Ausnahme aus InvalidArgument , wenn eine nicht positive ganze Zahl festgelegt wird.

Details zur Eigenschaft

format

Das gewünschte Format des resultierenden Bilds.

format?: PowerPoint.ShapeGetImageFormatType | "Png";

Eigenschaftswert

PowerPoint.ShapeGetImageFormatType | "Png"

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

height

Die gewünschte Höhe des resultierenden Bilds in Pixel. Dieser Wert wird automatisch auf die maximal unterstützte Größe geklemmt, wenn er zu groß ist. Löst eine Ausnahme aus InvalidArgument , wenn eine nicht positive ganze Zahl festgelegt wird.

height?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

width

Die gewünschte Breite des resultierenden Bilds in Pixel. Dieser Wert wird automatisch auf die maximal unterstützte Größe geklemmt, wenn er zu groß ist. Löst eine Ausnahme aus InvalidArgument , wenn eine nicht positive ganze Zahl festgelegt wird.

width?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.10 ]