Метод 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 в буфере обмена нет данных, возникает ошибка.
Если исходное содержимое загружено не полностью, этот метод завершается сбоем и возникает ошибка. Дополнительные сведения о частичных документах см. в разделе Работа с частичными документами.
См. также
Работа с частичными документами
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.