Bookmark.PasteSpecial - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
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 _
)

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);
}

Безопасность платформы .NET Framework

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

См. также

Ссылки

Bookmark Интерфейс

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

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