PowerPoint.PictureAddOptions interface
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
画像を追加するときに使用できるオプションを表します ( PowerPoint.Shape オブジェクトによって表されます)。
注釈
API セット: PowerPointApi BETA (プレビューのみ)
使用元
例
// 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();
});
プロパティ
| height | 図の高さをポイント単位で指定します。 指定しない場合、既定値は 72 ポイント (1 インチ) です。 負の値を設定すると、 |
| left | 図の左側からスライドの左側までの距離をポイント単位で指定します。 指定しない場合、既定値は 0 です。 |
| top | 図の上端からスライドの上端までの距離をポイント単位で指定します。 指定しない場合、既定値は 0 です。 |
| width | 図の幅をポイント単位で指定します。 指定しない場合、既定値は 72 ポイント (1 インチ) です。 負の値を設定すると、 |
プロパティの詳細
height
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
図の高さをポイント単位で指定します。 指定しない場合、既定値は 72 ポイント (1 インチ) です。 負の値を設定すると、 InvalidArgument 例外がスローされます。
height?: number;プロパティ値
number
注釈
left
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
図の左側からスライドの左側までの距離をポイント単位で指定します。 指定しない場合、既定値は 0 です。
left?: number;プロパティ値
number
注釈
top
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
図の上端からスライドの上端までの距離をポイント単位で指定します。 指定しない場合、既定値は 0 です。
top?: number;プロパティ値
number
注釈
width
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
図の幅をポイント単位で指定します。 指定しない場合、既定値は 72 ポイント (1 インチ) です。 負の値を設定すると、 InvalidArgument 例外がスローされます。
width?: number;プロパティ値
number