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.

Применяется к