Bookmark.PasteSpecial (Método)

Inserta el contenido del Portapapeles en el control Bookmark.

Espacio de nombres:  Microsoft.Office.Tools.Word
Ensamblado:  Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)

Sintaxis

'Declaración
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%
  Si DisplayAsIcon es true, este argumento es un número que corresponde al icono que se desea utilizar en el archivo de programa especificado por IconFilename.Los iconos aparecen en el cuadro de diálogo Cambiar icono: 0 (cero) corresponde al primer icono, 1 corresponde al segundo icono, etc.Si se omite este argumento, se utilizará el primer icono (predeterminado).

• Link
  Tipo: System.Object%
  true , para crear un vínculo al archivo de código fuente del contenido del Portapapeles.El valor predeterminado es false.

• Placement
  Tipo: System.Object%
  Puede ser una de las constantes WdOLEPlacement siguientes: wdFloatOverText o wdInLine.El valor predeterminado es wdInLine.

• DisplayAsIcon
  Tipo: System.Object%
  true , para mostrar el vínculo como un icono.El valor predeterminado es false.

• DataType
  Tipo: System.Object%
  Formato para el contenido del Portapapeles cuando se inserta en el documento.WdPasteDataType .

• IconFileName
  Tipo: System.Object%
  Si DisplayAsIcon es true, este argumento es la ruta de acceso y el nombre del archivo en que se almacena el icono que se va a mostrar.

• IconLabel
  Tipo: System.Object%
  Si DisplayAsIcon es true, este argumento es el texto que aparece debajo del icono.

Comentarios

A diferencia del método Paste, con PasteSpecial puede controlar el formato de la información pegada y (opcionalmente) establecer un vínculo al archivo de código fuente (por ejemplo, una hoja de cálculo de Microsoft Office Excel).

Llamar a este método podría eliminar el control Bookmark.

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

El ejemplo de código siguiente inserta el contenido del Portapapeles en el control Bookmark como texto sin formato.Este ejemplo supone que el Portapapeles contiene algún texto.

Se trata de un ejemplo para una personalización en el nivel del 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);
}

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

Bookmark Interfaz

Microsoft.Office.Tools.Word (Espacio de nombres)