WorksheetBase.PasteSpecial Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Excel

Сборка:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Вставляет в рабочий лист содержимое буфера обмена с использованием указанного формата. Данный метод используется для вставки данных из других приложений или вставки данных в определенном формате.

public void PasteSpecial (object format, object link, object displayAsIcon, object iconFileName, object iconIndex, object iconLabel, object noHTMLFormatting);

member this.PasteSpecial : obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub PasteSpecial (Optional format As Object, Optional link As Object, Optional displayAsIcon As Object, Optional iconFileName As Object, Optional iconIndex As Object, Optional iconLabel As Object, Optional noHTMLFormatting As Object)

Параметры

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.

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

Share via