Worksheet.PasteSpecial Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Sub PasteSpecial ( _
    Format As Object, _
    Link As Object, _
    DisplayAsIcon As Object, _
    IconFileName As Object, _
    IconIndex As Object, _
    IconLabel As Object, _
    NoHTMLFormatting As Object _
)
'Применение
Dim instance As Worksheet
Dim Format As Object
Dim Link As Object
Dim DisplayAsIcon As Object
Dim IconFileName As Object
Dim IconIndex As Object
Dim IconLabel As Object
Dim NoHTMLFormatting As Object

instance.PasteSpecial(Format, Link, DisplayAsIcon, _
    IconFileName, IconIndex, IconLabel, _
    NoHTMLFormatting)

public void PasteSpecial(
    Object Format,
    Object Link,
    Object DisplayAsIcon,
    Object IconFileName,
    Object IconIndex,
    Object IconLabel,
    Object NoHTMLFormatting
)

Параметры

Format
Тип: System.Object
Формат данных буфера обмена.

Link
Тип: System.Object
Значение true используется для установления связи с источником копируемых данных. Если исходные данные не допускают связывание или связывание не поддерживается исходным приложением, этот параметр игнорируется. Значение по умолчанию — false.

DisplayAsIcon
Тип: System.Object
Значение true используется для отображения вставляемого объекта в виде значка. Значение по умолчанию — false.

IconFileName
Тип: System.Object
Имя файла, содержащего используемый значок, если параметр DisplayAsIcon имеет значение true.

IconIndex
Тип: System.Object
Номер индекса значка в пределах файла значков.

IconLabel
Тип: System.Object
Текстовая метка значка.

NoHTMLFormatting
Тип: System.Object
Значение true для удаления любых элементов форматирования, гиперссылок и изображения из HTML-кода; значение false для вставки HTML-кода в неизменном виде. Значение по умолчанию — false.

Заметки

Параметр NoHTMLFormatting имеет смысл только в том случае, если параметр Format имеет значение "HTML". Во всех остальных случаях параметр NoHTMLFormatting игнорируются.

Если аргумент не задан, перед использованием данного метода необходимо выбрать диапазон назначения.

В зависимости от содержимого буфера обмена вызов этого метода может привести к изменению выделения листа.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В следующем примере кода в буфер обмена помещается текст HTML-код, после чего метод PasteSpecial используется для вставки содержимого буфера обмена в ячейку А1. Обратите внимание, что в этом примере перед вызовом метода PasteSpecial выделяется диапазон.

В этом примере демонстрируется настройка уровня документа.

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

private void PasteSpecialText()
{
    Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
        "</STRONG></BODY></HTML>");

    this.Range["A1", missing].Select();
    this.PasteSpecial(missing, false, false, missing, missing,
        missing, missing);
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Worksheet Класс

Worksheet - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через