PowerPoint.PictureAddOptions interface

Пакет:
powerpoint

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Представляет доступные параметры при добавлении рисунка (представленного объектом PowerPoint.Shape ).

Комментарии

Набор API: Бета-версия PowerPointApi (только предварительная версия)

Используется

Примеры

// 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 дюйм). InvalidArgument Создает исключение, если задано отрицательное значение.
left

Указывает расстояние (в точках) от левой части рисунка до левой части слайда. Если этот параметр не указан, значение по умолчанию равно 0.
top

Указывает расстояние (в точках) от верхнего края рисунка до верхнего края слайда. Если этот параметр не указан, значение по умолчанию равно 0.
width

Задает ширину рисунка (в точках). Если этот параметр не указан, значение по умолчанию равно 72 точкам (1 дюйм). InvalidArgument Создает исключение, если задано отрицательное значение.

Сведения о свойстве

height

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Задает высоту рисунка (в точках). Если этот параметр не указан, значение по умолчанию равно 72 точкам (1 дюйм). InvalidArgument Создает исключение, если задано отрицательное значение.

height?: number;

Значение свойства

number

Комментарии

Набор API: Бета-версия PowerPointApi (только предварительная версия)

left

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Указывает расстояние (в точках) от левой части рисунка до левой части слайда. Если этот параметр не указан, значение по умолчанию равно 0.

left?: number;

Значение свойства

number

Комментарии

Набор API: Бета-версия PowerPointApi (только предварительная версия)

top

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Указывает расстояние (в точках) от верхнего края рисунка до верхнего края слайда. Если этот параметр не указан, значение по умолчанию равно 0.

top?: number;

Значение свойства

number

Комментарии

Набор API: Бета-версия PowerPointApi (только предварительная версия)

width

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Задает ширину рисунка (в точках). Если этот параметр не указан, значение по умолчанию равно 72 точкам (1 дюйм). InvalidArgument Создает исключение, если задано отрицательное значение.

width?: number;

Значение свойства

number

Комментарии

Набор API: Бета-версия PowerPointApi (только предварительная версия)