PowerPoint.PictureAddOptions interface

Пакет:
powerpoint

Примечание

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

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

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

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

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

height

Примечание

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

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

height?: number;

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

number

Комментарии

Набор API: PowerPointApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ)

left

Примечание

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

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

left?: number;

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

number

Комментарии

Набор API: PowerPointApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ)

top

Примечание

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

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

top?: number;

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

number

Комментарии

Набор API: PowerPointApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ)

width

Примечание

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

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

width?: number;

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

number

Комментарии

Набор API: PowerPointApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ)