Bookmark.InsertCrossReference Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Word

Zestaw:: Microsoft.Office.Tools.Word.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wstawia odwołanie krzyżowe do nagłówka, zakładki, przypisu dolnego lub przypisu końcowego albo do elementu, dla którego zdefiniowano etykietę podpis (na przykład równanie, rysunek lub tabelę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)

Parametry

ReferenceType: Object

Typ elementu, dla którego ma zostać wstawione odwołanie krzyżowe. Może być dowolną WdReferenceType lub stałą lub WdCaptionLabelID zdefiniowaną przez użytkownika etykietą podpis.

ReferenceKind: WdReferenceKind

Informacje, które mają zostać uwzględnione w odwołaniu krzyżowym.

ReferenceItem: Object

Jeśli ReferenceType jest to wdRefTypeBookmark, ten argument określa nazwę zakładki. Dla wszystkich innych ReferenceType wartości ten argument określa numer lub nazwę elementu w polu Typ odwołania w oknie dialogowym Odwołanie krzyżowe. Użyj metody , GetCrossReferenceItems(Object) aby zwrócić listę nazw elementów, których można użyć z tym argumentem.

InsertAsHyperlink: Object

true aby wstawić odwołanie krzyżowe jako hiperłącze do elementu, do których odwołuje się odwołanie; w przeciwnym razie , false.

IncludePosition: Object

true w celu wstawienia powyżej lub poniżej, w zależności od lokalizacji elementu odniesienia w odniesieniu do odwołania krzyżowego.

SeparateNumbers: Object

true aby użyć separatora, aby oddzielić liczby od skojarzonego tekstu. (Użyj tylko wtedy, gdy ReferenceType parametr jest ustawiony na wdRefTypeNumberedItem , a ReferenceKind parametr jest ustawiony na wdNumberFullContext.)

SeparatorString: Object

Określa ciąg, który ma być używany jako separator, jeśli SeparateNumbers parametr ma wartość true.

Przykłady

Poniższy przykład kodu dodaje nagłówek i tekst do dokumentu przy użyciu Bookmark kontrolek, a następnie wstawia odwołanie krzyżowe do tekstu nagłówka.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Jeśli określisz wdPageNumber wartość , ReferenceKindmoże być konieczne ponowne przeładowanie dokumentu, aby wyświetlić poprawne informacje dotyczące odwołania krzyżowego.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.

Dotyczy

Udostępnij za pośrednictwem