Bookmark.InsertCrossReference Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Word

Ensamblado:: Microsoft.Office.Tools.Word.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inserta en un control Bookmark una referencia cruzada a un encabezado, un marcador, una nota a pie de página, una nota al final o a un elemento para el que se haya definido una etiqueta de título (por ejemplo, una ecuación, una figura o una tabla).

public void InsertCrossReference(ref object ReferenceType, Microsoft.Office.Interop.Word.WdReferenceKind ReferenceKind, ref object ReferenceItem, ref object InsertAsHyperlink, ref object IncludePosition, ref object SeparateNumbers, ref object SeparatorString);

abstract member InsertCrossReference : obj * Microsoft.Office.Interop.Word.WdReferenceKind * obj * obj * obj * obj * obj -> unit

Public Sub InsertCrossReference (ByRef ReferenceType As Object, ReferenceKind As WdReferenceKind, ByRef ReferenceItem As Object, Optional ByRef InsertAsHyperlink As Object, Optional ByRef IncludePosition As Object, Optional ByRef SeparateNumbers As Object, Optional ByRef SeparatorString As Object)

Parámetros

ReferenceType: Object

Tipo de elemento para el que se inserta una referencia cruzada. Puede ser cualquier constante WdReferenceType o WdCaptionLabelID, o una etiqueta de título definida por el usuario.

ReferenceKind: WdReferenceKind

Información que se va a incluir en la referencia cruzada.

ReferenceItem: Object

Si ReferenceType es wdRefTypeBookmark, este argumento especifica un nombre de marcador. Para todos los demás ReferenceType valores, este argumento especifica el número de elemento o el nombre en el cuadro Tipo de referencia del cuadro de diálogo Referencia cruzada. Utilice el método GetCrossReferenceItems(Object) para devolver una lista de nombres de elemento que se pueden utilizar con este argumento.

InsertAsHyperlink: Object

true, para insertar la referencia cruzada como un hipervínculo al elemento de referencia; de lo contrario, false.

IncludePosition: Object

true, para realizar la inserción antes o después en función de la ubicación del elemento de referencia con respecto a la referencia cruzada.

SeparateNumbers: Object

true, para utilizar un separador que separe los números del texto asociado. (Use solo si el ReferenceType parámetro está establecido wdRefTypeNumberedItem en y el ReferenceKind parámetro se establece en wdNumberFullContext).

SeparatorString: Object

Especifica la cadena que se va a usar como separador si el SeparateNumbers parámetro está establecido en true.

Ejemplos

En el ejemplo de código siguiente se agrega un encabezado y texto al documento mediante Bookmark controles y, a continuación, se inserta una referencia cruzada al texto del encabezado.

Este ejemplo es para una personalización de nivel de documento.

private void BookmarkInsertCrossReference()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.InsertParagraphBefore();

    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "Heading of Document";
    bookmark1.Style = "Heading 1";
    bookmark1.Delete();

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(this.Paragraphs[2].Range,
        "bookmark2");
    bookmark2.Text = "This is sample bookmark text: ";

    object ReferenceType = "Heading";
    object ReferenceItem = "1";
    object InsertAsHyperlink = true;
    object IncludePosition = false;
    object SeparateNumbers = false;
    object SeparatorString = " ";

    bookmark2.Words.Last.InsertCrossReference(ref ReferenceType,
        Word.WdReferenceKind.wdContentText, ref ReferenceItem, 
        ref InsertAsHyperlink, ref IncludePosition,
        ref SeparateNumbers, ref SeparatorString);
}

Private Sub BookmarkInsertCrossReference()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.InsertParagraphBefore()

    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "Heading of Document"
    Bookmark1.Style = "Heading 1"
    Bookmark1.Delete()

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(2).Range, "Bookmark2")
    Bookmark2.Text = "This is sample bookmark text: "

    Bookmark2.Words.Last.InsertCrossReference("Heading", _
        Word.WdReferenceKind.wdContentText, "1", True, _
        False, False, " ")

End Sub

Comentarios

Si especifica wdPageNumber para el valor de ReferenceKind, es posible que tenga que volver a paginar el documento para ver la información de referencia cruzada correcta.

Parámetros opcionales

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

Se aplica a

Compartir a través de