Bookmark.InsertCrossReference Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt in einem Bookmark-Steuerelement einen Querverweis in eine Überschrift, ein Lesezeichen, eine Fußnote, eine Endnote oder ein Element ein, für das ein Beschriftungstitel definiert ist (z. B. eine Gleichung, Abbildung oder Tabelle).

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)

Parameter

ReferenceType: Object

Der Typ des Elements, für den ein Querverweis eingefügt werden soll. Kann eine beliebige WdReferenceType-Konstante, eine beliebige WdCaptionLabelID-Konstante oder ein benutzerdefinierter Beschriftungstitel sein.

ReferenceKind: WdReferenceKind

Die in den Querverweis einzuschließenden Informationen.

ReferenceItem: Object

Wenn ReferenceType ist wdRefTypeBookmark, gibt dieses Argument einen Lesezeichennamen an. Für alle anderen ReferenceType Werte gibt dieses Argument die Elementnummer oder den Namen im Feld Verweistyp im Dialogfeld Querverweis an. Verwenden Sie die GetCrossReferenceItems(Object)-Methode, um eine Liste der Elementnamen zurückzugeben, die mit diesem Argument verwendet werden kann.

InsertAsHyperlink: Object

true, um den Querverweis als Link zu dem Element einzufügen, auf das verwiesen wird; andernfalls false.

IncludePosition: Object

true, um je nach Position des Verweiselements in Bezug auf den Querverweis die Einfügung oberhalb oder unterhalb auszuführen.

SeparateNumbers: Object

true, um zum Trennen der Zahlen vom zugeordneten Text ein Trennzeichen zu verwenden. (Verwenden Sie nur, wenn der ReferenceType Parameter auf wdRefTypeNumberedItem festgelegt ist und der ReferenceKind Parameter auf wdNumberFullContextfestgelegt ist.)

SeparatorString: Object

Gibt die Zeichenfolge an, die als Trennzeichen verwendet werden soll, wenn der SeparateNumbers Parameter auf truefestgelegt ist.

Beispiele

Das folgende Codebeispiel fügt dem Dokument mithilfe von Bookmark Steuerelementen eine Überschrift und Text hinzu und fügt dann einen Querverweis auf den Überschriftentext ein.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Hinweise

Wenn Sie für den Wert von ReferenceKindangebenwdPageNumber, müssen Sie das Dokument möglicherweise neu konfigurieren, um die richtigen Querverweisinformationen anzuzeigen.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über