Bookmark.PasteSpecial Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Insere o conteúdo da área de transferência no controle Bookmark.

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

abstract member PasteSpecial : obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub PasteSpecial (Optional ByRef IconIndex As Object, Optional ByRef Link As Object, Optional ByRef Placement As Object, Optional ByRef DisplayAsIcon As Object, Optional ByRef DataType As Object, Optional ByRef IconFileName As Object, Optional ByRef IconLabel As Object)

Parâmetros

IconIndex: Object

Se DisplayAsIcon for true, esse argumento será um número que corresponde ao ícone que você deseja usar no arquivo de programa especificado por IconFilename. Os ícones aparecem na caixa de diálogo Alterar Ícone: 0 (zero) corresponde ao primeiro ícone, 1 corresponde ao segundo ícone e assim por diante. Se esse argumento for omitido, o primeiro ícone (padrão) será usado.

Link: Object

true para criar um link para o arquivo de origem do conteúdo da área de transferência. O valor padrão é false.

Placement: Object

Pode ser uma das seguintes constantes WdOLEPlacement: wdFloatOverText ou wdInLine. O valor padrão é wdInLine.

DisplayAsIcon: Object

true para exibir o link como um ícone. O valor padrão é false.

DataType: Object

Um formato para o conteúdo da área de transferência quando ele é inserido no documento. WdPasteDataType.

IconFileName: Object

Se DisplayAsIcon for true, esse argumento será o caminho e o nome do arquivo no qual o ícone a ser exibido será armazenado.

IconLabel: Object

Se DisplayAsIcon for true, esse argumento será o texto que aparece abaixo do ícone.

Exemplos

O exemplo de código a seguir insere o conteúdo da Área de Transferência no Bookmark controle como texto não formatado. Este exemplo pressupõe que a Área de Transferência contenha algum texto.

Este exemplo destina-se a uma personalização no nível de documento.

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

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

Comentários

Ao contrário do Paste método , com PasteSpecial você pode controlar o formato das informações coladas e (opcionalmente) estabelecer um link para o arquivo de origem (por exemplo, uma planilha do Microsoft Office Excel).

A chamada desse método pode excluir o controle Bookmark.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Aplica-se a

Compartilhar via