Bookmark.InsertCrossReference Metoda

  • Odwołanie

Definicja

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

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