WorksheetBase.PasteSpecial(Object, Object, Object, Object, Object, Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет в рабочий лист содержимое буфера обмена с использованием указанного формата. Данный метод используется для вставки данных из других приложений или вставки данных в определенном формате.
public void PasteSpecial (object format, object link, object displayAsIcon, object iconFileName, object iconIndex, object iconLabel, object noHTMLFormatting);
Параметры
- format
- Object
Строка, задающая формат буфера обмена для данных. Строки общих форматов включают следующее: "HTML", "Bitmap", "Hyperlink", "Unicode Text" и "Text".
- link
- Object
Значение true используется для установления связи с источником копируемых данных. Если исходные данные не допускают связывание или связывание не поддерживается исходным приложением, этот параметр игнорируется. Значение по умолчанию — false.
- displayAsIcon
- Object
Значение true используется для отображения вставляемого объекта в виде значка. Значение по умолчанию — false.
- iconFileName
- Object
Имя файла, содержащего используемый значок, если параметр DisplayAsIcon имеет значение true.
- iconIndex
- Object
Номер индекса значка в пределах файла значков.
- iconLabel
- Object
Текстовая метка значка.
- noHTMLFormatting
- Object
Значение true для удаления любых элементов форматирования, гиперссылок и изображения из HTML-кода; значение false для вставки HTML-кода в неизменном виде. Значение по умолчанию — false.
Примеры
В следующем примере кода HTML помещается в буфер обмена, а затем используется PasteSpecial метод для вставки содержимого буфера обмена в ячейку a1. Обратите внимание, что в примере выбирается диапазон перед вызовом PasteSpecial метода.
Этот пример предназначен для настройки на уровне документа.
private void PasteSpecialText()
{
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
"</STRONG></BODY></HTML>");
this.Range["A1"].Select();
this.PasteSpecial(missing, false, false);
}
Private Sub PasteSpecialText()
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" & _
"</STRONG></BODY></HTML>")
Me.Range("A1").Select()
Me.PasteSpecial(Link:=False, DisplayAsIcon:=False)
End Sub
Комментарии
Если вы не уверены, какую строку следует передать в параметр format, можно просмотреть строки, совместимые с данными в буфере обмена, выполнив команду вставки в Excel. Скопируйте данные в буфер обмена, используйте команду "Специальная Вставка " в Excel, а затем просмотрите форматы, перечисленные в диалоговом окне " Специальная вставка ".
NoHTMLFormattingимеет значение, только если Format = "HTML". Во всех остальных случаях NoHTMLFormatting будет игнорироваться.
Перед использованием этого метода необходимо выбрать диапазон назначения.
Этот метод может изменить выбор листа в зависимости от содержимого буфера обмена.
Необязательные параметры
Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.