Bookmark.InsertCrossReference-Methode

  • Artikel

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).

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

Syntax

'Declaration
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
)

Parameter

  • ReferenceType
    Typ: System.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.
  • ReferenceItem
    Typ: System.Object%
    Wenn ReferenceType wdRefTypeBookmark ist, gibt dieses Argument einen Lesezeichennamen an.Für alle anderen ReferenceType-Werte gibt dieses Argument im Dialogfeld Querverweis im Feld Referenztyp die Nummer oder den Namen des Elements an.Verwenden Sie die GetCrossReferenceItems-Methode, um eine Liste der Elementnamen zurückzugeben, die mit diesem Argument verwendet werden kann.
  • InsertAsHyperlink
    Typ: System.Object%
    true, um den Querverweis als Link zu dem Element einzufügen, auf das verwiesen wird; andernfalls false.
  • IncludePosition
    Typ: System.Object%
    true, um je nach Position des Verweiselements in Bezug auf den Querverweis die Einfügung oberhalb oder unterhalb auszuführen.
  • SeparateNumbers
    Typ: System.Object%
    true, um zum Trennen der Zahlen vom zugeordneten Text ein Trennzeichen zu verwenden.(Verwenden Sie dies nur, wenn der ReferenceType-Parameter auf wdRefTypeNumberedItem festgelegt ist und der ReferenceKind-Parameter auf wdNumberFullContext festgelegt ist.)
  • SeparatorString
    Typ: System.Object%
    Gibt die Zeichenfolge an, die als Trennzeichen verwendet werden soll, wenn der SeparateNumbers-Parameter auf true festgelegt ist.

Hinweise

Wenn für den Wert von ReferenceKind wdPageNumber angegeben wird, müssen Sie möglicherweise die Seiten des Dokuments neu nummerieren, damit die richtigen Querverweisinformationen angezeigt werden.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird dem Dokument mithilfe des Bookmark-Steuerelements eine Überschrift sowie ein Text hinzugefügt und anschließend ein Querverweis zum Text der Überschrift eingefügt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace