PowerPoint.AddSlideOptions interface

パッケージ:

powerpoint

新しいスライドを追加するときに使用できるオプションを表します。

注釈

[ API セット: PowerPointApi 1.3 ]

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/add-slides.yaml

const chosenMaster = $("#master-id").val() as string;
const chosenLayout = $("#layout-id").val() as string;

await PowerPoint.run(async function(context) {
  // Create a new slide using an existing master slide and layout.
  const newSlideOptions: PowerPoint.AddSlideOptions = {
    slideMasterId: chosenMaster, /* An ID from `Presentation.slideMasters`. */
    layoutId: chosenLayout /* An ID from `SlideMaster.layouts`. */
  };
  context.presentation.slides.add(newSlideOptions);
  await context.sync();
});

プロパティ

layoutId	新しいスライドに使用するスライド レイアウトの ID を指定します。 layoutIdが指定されていないが、slideMasterIdが指定されている場合は、指定したスライド マスターからの最初のレイアウトの ID が使用されます。 slideMasterIdが指定されていないが、layoutIdが指定されている場合は、既定のスライド マスター (slideMasterId説明で指定されている) で指定したレイアウトを使用できる必要があります。 それ以外の場合は、エラーがスローされます。
slideMasterId	新しいスライドに使用するスライド マスターの ID を指定します。 slideMasterIdが指定されていない場合は、前のスライドのスライド マスターが使用されます。 前のスライドがない場合は、プレゼンテーションの最初のスライド マスターが使用されます。

プロパティの詳細

layoutId

新しいスライドに使用するスライド レイアウトの ID を指定します。 layoutIdが指定されていないが、slideMasterIdが指定されている場合は、指定したスライド マスターからの最初のレイアウトの ID が使用されます。 slideMasterIdが指定されていないが、layoutIdが指定されている場合は、既定のスライド マスター (slideMasterId説明で指定されている) で指定したレイアウトを使用できる必要があります。 それ以外の場合は、エラーがスローされます。

layoutId?: string;

プロパティ値

string

注釈

[ API セット: PowerPointApi 1.3 ]

slideMasterId

新しいスライドに使用するスライド マスターの ID を指定します。 slideMasterIdが指定されていない場合は、前のスライドのスライド マスターが使用されます。 前のスライドがない場合は、プレゼンテーションの最初のスライド マスターが使用されます。

slideMasterId?: string;

プロパティ値

string

注釈

[ API セット: PowerPointApi 1.3 ]