Método Bookmark.PasteSpecial

Artigo
08/01/2011

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

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
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
)

Parâmetros

IconIndex
Tipo: System.Object%
Se DisplayAsIcon é true, esse argumento é um número que corresponde ao ícone você deseja usar no arquivo de programa especificado por IconFilename.Os ícones aparecem na Alterar ícone caixa de diálogo: 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) é usado.

Link
Tipo: System.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
Tipo: System.Object%
Pode ser uma das seguintes WdOLEPlacement constantes: wdFloatOverText or wdInLine.O valor padrão é wdInLine.

DisplayAsIcon
Tipo: System.Object%
true Para exibir o link como um ícone.O valor padrão é false.

DataType
Tipo: System.Object%
Um formato para o conteúdo da área de transferência quando são inseridos no documento.WdPasteDataType.

IconFileName
Tipo: System.Object%
Se DisplayAsIcon é true, esse argumento é o caminho e nome de arquivo para o arquivo no qual o ícone a ser exibido está armazenado.

IconLabel
Tipo: System.Object%
Se DisplayAsIcon é true, este argumento é o texto que aparece abaixo do ícone.

Comentários

Ao contrário com o 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 Excel de Microsoft Office).

Este método pode excluir de chamada a Bookmark de controle.

Optional Parameters

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

Exemplos

O exemplo de código a seguir insere o conteúdo da área de transferência de Bookmark controle como texto sem formatação. Este exemplo assume que a área de transferência contém algum texto.

Este exemplo é para uma personalização em nível de documento.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word

Partilhar via