Método Bookmark.InsertCrossReference

Artigo
05/21/2013

Insere uma referência a um título, cruzada para um marcador, a uma nota de rodapé, ou a uma nota de fim, ou a um item para o qual um rótulo de legenda é definida (por exemplo, uma equação, uma figura, ou uma tabela) em um controle de Bookmark .

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 que uma referência cruzada deve ser inserido.Podem ser qualquer constante de WdReferenceType ou de WdCaptionLabelID ou um rótulo definido pelo usuário da legenda.

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

ReferenceItem
Tipo: System.Object%
Se ReferenceType é wdRefTypeBookmark, esse argumento especifica um nome do indexador.Para todos os outros valores de ReferenceType , esse argumento especifica o número do artigo ou o nome na caixa de Tipo de Referência na caixa de diálogo de Referência Cruzada .Use o método de GetCrossReferenceItems para retornar uma lista de nomes de item que podem ser usados com esse 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 de, dependendo do local do item de referência com relação a referência cruzada.

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

SeparatorString
Tipo: System.Object%
Especifica a cadeia de caracteres para usar como um separador se o parâmetro de SeparateNumbers é definido como true.

Comentários

Se você especificar wdPageNumber para o valor de ReferenceKind, você talvez precise repaginate o documento para ver a informação correta de referência cruzada.

Parâmetros Opcionais

Para obter informações sobre 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 texto ao documento usando controles de Bookmark e insira uma referência cruzada para o texto do título.

Este exemplo é para uma personalização da nível.

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

Partilhar via