Método Bookmark.InsertCrossReference

Artigo
08/01/2011

Insere uma referência cruzada para 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, figura ou tabela) em um Bookmark de controle.

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

Sintaxe

'Declaração
Sub InsertCrossReference ( _
    ByRef ReferenceType As Object, _
    ReferenceKind As WdReferenceKind, _
    ByRef ReferenceItem As Object, _
    ByRef InsertAsHyperlink As Object, _
    ByRef IncludePosition As Object, _
    ByRef SeparateNumbers As Object, _
    ByRef SeparatorString As Object _
)

void InsertCrossReference(
    ref Object ReferenceType,
    WdReferenceKind ReferenceKind,
    ref Object ReferenceItem,
    ref Object InsertAsHyperlink,
    ref Object IncludePosition,
    ref Object SeparateNumbers,
    ref Object SeparatorString
)

Parâmetros

ReferenceType
Tipo: System.Object%
O tipo de item para o qual uma referência cruzada a ser inserido.Pode ser qualquer WdReferenceType ou WdCaptionLabelID constante ou um rótulo de legenda definido pelo usuário.

ReferenceKind
Tipo: Microsoft.Office.Interop.Word.WdReferenceKind
As informações a serem incluídas na referência cruzada.

ReferenceItem
Tipo: System.Object%
Se ReferenceType é wdRefTypeBookmark, esse argumento especifica um nome de indicador.Para todos os outros ReferenceType valores, esse argumento especifica o número de item ou nome na tipo de referência caixa a referência cruzada caixa de diálogo.Use o GetCrossReferenceItems método para retornar uma lista de nomes de item que pode ser usado com este argumento.

InsertAsHyperlink
Tipo: System.Object%
true Para inserir a referência cruzada como um hiperlink para o item referenciado; Caso contrário, false.

IncludePosition
Tipo: System.Object%
true Para inserir acima ou abaixo, dependendo da localização do item de referência em relação à referência cruzada.

SeparateNumbers
Tipo: System.Object%
true Para usar um separador para separar os números do texto associado.(Use somente se o ReferenceType parâmetro for definido como wdRefTypeNumberedItem e o ReferenceKind parâmetro for definido como wdNumberFullContext.)

SeparatorString
Tipo: System.Object%
Especifica a seqüência de caracteres para usar como um separador se o SeparateNumbers parâmetro for definido como true.

Comentários

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

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 adiciona um título e o texto ao documento usando Bookmark controla e insere uma referência cruzada para o texto do título.

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

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

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

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

Compartilhar via