Bookmark.InsertCrossReference 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 uma referência cruzada a um título, indicador, nota de rodapé ou nota de fim ou para um item para o qual um nome de legenda é definido (por exemplo, uma equação, uma figura ou uma tabela) em um controle Bookmark.

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

O tipo de item para o qual uma referência cruzada deve ser inserida. Pode ser qualquer constante WdReferenceType ou WdCaptionLabelID ou um rótulo de legenda definido pelo usuário.

ReferenceKind: WdReferenceKind

As informações a serem incluídas na referência cruzada.

ReferenceItem: Object

Se ReferenceType for wdRefTypeBookmark, esse argumento especificará um nome de indicador. Para todos os outros ReferenceType valores, esse argumento especifica o número ou o nome do item na caixa Tipo de referência na caixa de diálogo Referência cruzada. Use o método GetCrossReferenceItems(Object) para retornar uma lista de nomes de item que podem ser usados com esse argumento.

InsertAsHyperlink: Object

true para inserir a referência cruzada como um hiperlink para o item referenciado; caso contrário, false.

IncludePosition: Object

true para inserir acima ou abaixo, dependendo da localização do item de referência em relação à referência cruzada.

SeparateNumbers: Object

true para usar um separador para separar os números do texto associado. (Use somente se o ReferenceType parâmetro estiver definido wdRefTypeNumberedItem como e o ReferenceKind parâmetro estiver definido como wdNumberFullContext.)

SeparatorString: Object

Especifica a cadeia de caracteres a ser usada como separador se o SeparateNumbers parâmetro estiver definido truecomo .

Exemplos

O exemplo de código a seguir adiciona um título e um texto ao documento usando Bookmark controles e insere uma referência cruzada ao texto do título.

Este exemplo destina-se a uma personalização no nível 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

Comentários

Se você especificar wdPageNumber para o valor de ReferenceKind, talvez seja necessário repaginar o documento para ver as informações de referência cruzada corretas.

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