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

Статья
11/16/2008

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

Вставляет в элемент управления Bookmark содержимое буфера обмена.

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

Синтаксис

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

instance.PasteSpecial(IconIndex, Link, _
    Placement, DisplayAsIcon, DataType, _
    IconFileName, IconLabel)

public void PasteSpecial(
    ref Object IconIndex,
    ref Object Link,
    ref Object Placement,
    ref Object DisplayAsIcon,
    ref Object DataType,
    ref Object IconFileName,
    ref Object IconLabel
)

Параметры

IconIndex
Тип: System.Object%
Если параметру DisplayAsIcon присвоено значение true, этот аргумент является числом, соответствующим значку, который требуется использовать в файле программы, указанном в параметре IconFilename. Значки представлены в диалоговом окне Смена значка: значение 0 (ноль) соответствует первому значку, 1 — второму и т. д. Если этот аргумент не задан, используется первый значок (по умолчанию).

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

Placement
Тип: System.Object%
Свойство может принимать значения одной из следующих констант WdOLEPlacement: wdFloatOverText или wdInLine. Значение по умолчанию — wdInLine.

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

DataType
Тип: System.Object%
Формат содержимого буфера обмена при вставке этого содержимого в документ. WdPasteDataType.

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

IconLabel
Тип: System.Object%
Если параметру DisplayAsIcon присвоено значение true, этот аргумент представляет текст, отображаемый под значком.

Заметки

В отличие от метода Paste, с помощью метода PasteSpecial можно управлять форматом вставляемых данных, а также (необязательно) устанавливать связь с исходным файлом (например, с листом Microsoft Office Excel).

В результате вызова этого метода элемент управления Bookmark может быть удален.

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

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

Примеры

В приведенном ниже примере кода содержимое буфера обмена вставляется в элемент управления Bookmark в виде неформатированного текста. В данном примере предполагается, что в буфере обмена содержится текст.

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

Private Sub BookmarkPasteSpecial()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.PasteSpecial(DataType:=Word.WdPasteDataType.wdPasteText)

End Sub

private void BookmarkPasteSpecial()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");

    object DataType = Word.WdPasteDataType.wdPasteText;
    bookmark1.PasteSpecial(ref missing, ref missing, ref missing,
        ref missing, ref DataType, ref missing, ref missing);
}

Разрешения

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

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