Поделиться через

Метод Shapes.PasteSpecial (PowerPoint)

  • Статья

Вставляет содержимое буфера обмена с использованием специального формата.

Синтаксис

expression. PasteSpecial (DataType, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Link)

выражение: переменная, представляющая объект Shapes.

Параметры

Имя Обязательный или необязательный Тип данных Описание
DataType Необязательный PpPasteDataType Формат для содержимого буфера обмена при вставке в документ. Значение по умолчанию зависит от содержимого в буфере обмена. Если указанный тип данных в аргументе DataType не поддерживается содержимым буфера обмена, возникает ошибка.
DisplayAsIcon Необязательный MsoTriState MsoTrue для отображения внедренного объекта (или ссылки) в виде значка.
IconFileName Необязательный String Если параметр DisplayAsIcon имеет значение msoTrue, этот аргумент является путем и именем файла, в котором хранится отображаемый значок. Если параметр DisplayAsIcon имеет значение msoFalse, этот аргумент игнорируется.
IconIndex Необязательный Long Если параметр DisplayAsIcon имеет значение msoTrue, этот аргумент представляет собой число, соответствующее значку, который вы хотите использовать в файле программы, заданном параметром IconFilename. Например, 0 (ноль) соответствует первому значку, а 1 — второму. Если этот аргумент опущен, используется первый значок (по умолчанию). Если параметр DisplayAsIcon имеет значение msoFalse, этот аргумент игнорируется. Если IconIndex находится за пределами допустимого диапазона, используется значок по умолчанию (индекс 0).
IconLabel Необязательный String Если параметр DisplayAsIcon имеет значение msoTrue, этот аргумент представляет собой текст, отображаемый под значком. Если эта метка отсутствует, Microsoft PowerPoint создает метку значка на основе содержимого буфера обмена. Если параметр DisplayAsIcon имеет значение msoFalse, этот аргумент игнорируется.
Link Необязательный MsoTriState Определяет, следует ли создать ссылку на исходный файл содержимого буфера обмена. Если содержимое буфера обмена не поддерживает ссылку, возникает ошибка.

Возвращаемое значение

ShapeRange

Замечания

Добавляет фигуру в коллекцию фигур в указанном формате. Если указанный тип данных является текстовым, создается новое текстовое поле с текстом. Если вставка выполнена успешно, метод PasteSpecial возвращает объект ShapeRange , представляющий вставленный диапазон фигур.

Значение параметра DataType может быть одной из следующих констант PpPasteDataType :

  • ppPasteBitmap
  • ppPasteDefault
  • ppPasteEnhancedMetafile
  • ppPasteHTML
  • ppPasteGIF
  • ppPasteJPG
  • ppPasteMetafilePicture
  • ppPastePNG
  • ppPasteShape

Значение параметра DisplayAsIcon может быть одной из этих констант MsoTriState .

Константа Описание
msoFalse Значение по умолчанию. Не отображает внедренный объект (или ссылку) в виде значка.
msoTrue Отображает внедренный объект (или ссылку) в виде значка.

Если при вызове метода PasteSpecial в буфере обмена нет данных, возникает ошибка.

Если исходное содержимое загружено не полностью, этот метод завершается сбоем и возникает ошибка. Дополнительные сведения о частичных документах см. в разделе Работа с частичными документами.

См. также

Объект Shapes

Работа с частичными документами

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.