- Selection.PasteSpecial method (Word)
- Syntax
- Parameters
- Remarks
- Example
- See also
- Support and feedback
- VBA Excel. Метод Range.PasteSpecial (специальная вставка)
- Метод Range.PasteSpecial
- Синтаксис
- Параметры специальной вставки
- Константы XlPasteType
- Константы XlPasteSpecialOperation
- Примеры
- Selection.PasteSpecial method (Word)
- Синтаксис
- Параметры
- Замечания
- Пример
- См. также
- Поддержка и обратная связь
- Метод Worksheet.PasteSpecial (Excel)
- Синтаксис
- Параметры
- Замечания
- Пример
- Поддержка и обратная связь
Selection.PasteSpecial method (Word)
Inserts the contents of the Clipboard.
Syntax
expression.PasteSpecial (IconIndex, Link, Placement, DisplayAsIcon, DataType, IconFileName, IconLabel)
expression Required. A variable that represents a Selection object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| IconIndex | Optional | Variant | If DisplayAsIcon is True, this argument is a number that corresponds to the icon you want to use in the program file specified by IconFilename. If this argument is omitted, this method uses the first (default) icon. |
| Link | Optional | Variant | True to create a link to the source file of the Clipboard contents. The default value is False. |
| Placement | Optional | Variant | Can be either of the WdOLEPlacement constants. |
| DisplayAsIcon | Optional | Variant | True to display the link as an icon. The default value is False. |
| DataType | Optional | Variant | A format for the Clipboard contents when they are inserted into the document. WdPasteDataType. |
| IconFileName | Optional | Variant | If DisplayAsIcon is True, this argument is the path and file name for the file in which the icon to be displayed is stored. |
| IconLabel | Optional | Variant | If DisplayAsIcon is True, this argument is the text that appears below the icon. |
Remarks
Unlike with the Paste method, with PasteSpecial you can control the format of the pasted information and (optionally) establish a link to the source file (for example, a Microsoft Excel worksheet). If you don’t want to replace the contents of the specified selection, use the Collapse method before you use this method. When you use this method, the selection does not expand to include the contents of the Clipboard.
Example
This example inserts the Clipboard contents at the insertion point as unformatted text.
See also
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.
VBA Excel. Метод Range.PasteSpecial (специальная вставка)
Специальная вставка (метод PasteSpecial объекта Range) применяется в VBA Excel для вставки ячеек из буфера обмена с учетом заданных параметров.
Метод Range.PasteSpecial
Синтаксис
Специальная вставка работает только с данными ячеек, скопированными в буфер обмена методом Range.Copy. При попытке применить метод Range.PasteSpecial к ячейкам, вырезанным в буфер обмена методом Range.Cut, возникает ошибка.
Параметры специальной вставки
Список параметров метода Range.PasteSpecial:
| Параметры | Описание |
|---|---|
| Paste | Необязательный параметр. Константа из коллекции XlPasteType, указывающая на часть данных вставляемого диапазона, которую следует вставить. По умолчанию вставляются все данные. |
| Operation | Необязательный параметр. Константа из коллекции XlPasteSpecialOperation, указывающая на математические операции, которые следует провести со скопированными данными и данными в ячейках назначения. По умолчанию вычисления не производятся. |
| SkipBlanks | Необязательный параметр. Булево значение, которое указывает, вставлять ли в конечный диапазон пустые ячейки: True – не вставлять, False – вставлять (значение по умолчанию). |
| Transpose | Необязательный параметр. Булево значение, которое указывает, следует ли транспонировать строки и столбцы при вставке диапазона: True – транспонировать, False – не транспонировать (значение по умолчанию). |
Смотрите другой способ транспонировать диапазоны ячеек и двумерные массивы.
Константы XlPasteType
Список констант из коллекции XlPasteType, которые могут быть использованы в качестве аргумента параметра Paste:
| Константа | Значение | Описание |
|---|---|---|
| xlPasteAll | -4104 | Вставка всех данных (по умолчанию). |
| xlPasteAllExceptBorders | 7 | Вставка всех данных, кроме границ. |
| xlPasteAllMergingConditionalFormats | 14 | Вставка всех данных со слиянием условных форматов исходного и нового диапазонов. |
| xlPasteAllUsingSourceTheme | 13 | Вставка всех данных с использованием исходной темы. |
| xlPasteColumnWidths | 8 | Вставка ширины столбцов. |
| xlPasteComments | -4144 | Вставка комментариев. |
| xlPasteFormats | -4122 | Вставка форматов исходного диапазона. |
| xlPasteFormulas | -4123 | Вставка формул. |
| xlPasteFormulasAndNumberFormats | 11 | Вставка формул и форматов чисел. |
| xlPasteValidation | 6 | Вставка правил проверки данных из ячеек исходного диапазона в новый диапазон. |
| xlPasteValues | -4163 | Вставка значений. |
| xlPasteValuesAndNumberFormats | 12 | Вставка значений и форматов чисел. |
Константы XlPasteSpecialOperation
Список констант из коллекции XlPasteSpecialOperation, которые могут быть использованы в качестве аргумента параметра Operation:
| Константа | Значение | Описание |
|---|---|---|
| xlPasteSpecialOperationAdd | 2 | Скопированные данные будут добавлены к значениям в ячейках назначения. |
| xlPasteSpecialOperationDivide | 5 | Скопированные данные разделят значения в ячейках назначения. |
| xlPasteSpecialOperationMultiply | 4 | Скопированные данные будут перемножены со значениями в ячейках назначения. |
| xlPasteSpecialOperationNone | -4142 | Вычисления не выполняются при вставке данных (по умолчанию). |
| xlPasteSpecialOperationSubtract | 3 | Скопированные данные будут вычтены из значений в ячейках назначения. |
Примеры
Примеры копирования и специальной вставки актуальны для диапазона «A1:B8» активного листа, ячейки которого заполнены числами:
Selection.PasteSpecial method (Word)
Вставляет содержимое буфера обмена.
Синтаксис
expression. PasteSpecial (IconIndex, Link, Placement, DisplayAsIcon, DataType, IconFileName, IconLabel)
выражение (обязательно). Переменная, представляющая объект Selection .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| IconIndex | Необязательный | Variant | Если параметр DisplayAsIcon имеет значение True, этот аргумент представляет собой число, соответствующее значку, который вы хотите использовать в файле программы, заданном параметром IconFilename. Если этот аргумент опущен, этот метод использует первый значок (по умолчанию). |
| Link | Необязательный | Variant | Значение true , чтобы создать ссылку на исходный файл содержимого буфера обмена. Значение по умолчанию — False. |
| Placement | Необязательный | Variant | Может быть любой из констант WdOLEPlacement . |
| DisplayAsIcon | Необязательный | Variant | Значение true , чтобы отобразить ссылку в виде значка. Значение по умолчанию — False. |
| DataType | Необязательный | Variant | Формат для содержимого буфера обмена при его вставке в документ. WdPasteDataType. |
| IconFileName | Необязательный | Variant | Если параметр DisplayAsIcon имеет значение True, этот аргумент является путем и именем файла, в котором хранится отображаемый значок. |
| IconLabel | Необязательный | Variant | Если параметр DisplayAsIcon имеет значение True, этот аргумент представляет собой текст, который отображается под значком. |
Замечания
В отличие от метода Paste , с помощью PasteSpecial можно управлять форматом вставленной информации и (при необходимости) установить ссылку на исходный файл (например, лист Microsoft Excel). Если вы не хотите заменять содержимое указанного выделенного фрагмента, перед использованием этого метода используйте метод Collapse . При использовании этого метода выделение не расширяется, чтобы включить содержимое буфера обмена.
Пример
В этом примере содержимое буфера обмена вставляется в точку вставки как неформатированный текст.
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.
Метод Worksheet.PasteSpecial (Excel)
Вставляет содержимое буфера обмена на лист в указанном формате. Используйте этот метод для вставки данных из других приложений или для вставки данных в определенном формате.
Синтаксис
expression. PasteSpecial (Format, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, NoHTMLFormatting)
Выражение Переменная, представляющая объект Worksheet .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| Format | Необязательный | Variant | Строка, указывающая формат буфера обмена данных. |
| Link | Необязательный | Variant | Значение true , чтобы установить связь с источником вставленных данных. Если исходные данные не подходят для связывания или исходное приложение не поддерживает связывание, этот параметр игнорируется. Значение по умолчанию — False. |
| DisplayAsIcon | Необязательный | Variant | Значение true для отображения вставленных данных в виде значка. Значение по умолчанию — False. |
| IconFileName | Необязательный | Variant | Имя файла, содержащего значок для использования, если DisplayAsIcon имеет значение True. |
| IconIndex | Необязательный | Variant | Номер индекса значка в файле значка. |
| IconLabel | Необязательный | Variant | Текстовая метка значка. |
| NoHTMLFormatting | Необязательный | Variant | Значение true , чтобы удалить все форматирование, гиперссылки и изображения из HTML. Значение False для вставки HTML как есть. Значение по умолчанию — False. |
Замечания
Значение NoHTMLFormatting имеет значение только в том случае, если Format = «HTML»; Во всех остальных случаях параметр NoHTMLFormatting игнорируется.
Перед использованием этого метода необходимо выбрать диапазон назначения.
Этот метод может изменить выбранный лист в зависимости от содержимого буфера обмена.
Для разработчиков языков, отличных от английского, можно заменить одну из следующих констант (0–5), чтобы она соответствовала строковой эквивалентной формату файла рисунка.
| Аргумент Format | Эквивалент строки |
|---|---|
| 0 | «Рисунок (PNG)» |
| 1 | «Рисунок (JPEG)» |
| 2 | «Рисунок (GIF)» |
| 3 | «Изображение (расширенный метафайл)» |
| 4 | «Растровое изображение» |
| 5 | «Объект документа Microsoft Office» |
Пример
В этом примере объект документа Microsoft Word вставляется из буфера обмена в ячейку D1 на Листе1.
В этом примере объект рисунка вставляется и не отображается в виде значка.
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.