Bookmark.InsertCrossReference Méthode

Définition

Insère dans un contrôle Bookmark un renvoi à un titre, un signet, une note de bas de page ou de fin, ou à un élément pour lequel un intitulé de légende est défini (par exemple, une équation, une illustration ou un tableau).

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)

Paramètres

ReferenceType
Object

Type d'élément pour lequel un renvoi sera inséré. Peut être toute constante WdReferenceType ou WdCaptionLabelID ou un intitulé de légende défini par l'utilisateur.

ReferenceKind
WdReferenceKind

Informations à inclure dans le renvoi.

ReferenceItem
Object

Si ReferenceType est wdRefTypeBookmark, cet argument spécifie un nom de signet. Pour toutes les autres ReferenceType valeurs, cet argument spécifie le numéro ou le nom de l’élément dans la zone Type de référence de la boîte de dialogue Référence croisée. Utilisez la méthode GetCrossReferenceItems(Object) pour retourner une liste des noms d'éléments qui peuvent être utilisés avec cet argument.

InsertAsHyperlink
Object

true pour insérer le renvoi en tant que lien hypertexte vers l'élément référencé ; sinon, false.

IncludePosition
Object

true pour effectuer l'insertion au-dessus ou au-dessous, selon l'emplacement de l'élément de référence par rapport au renvoi.

SeparateNumbers
Object

true pour utiliser un séparateur entre les numéros et le texte associé. (Utilisez uniquement si le paramètre a la ReferenceTypewdRefTypeNumberedItem valeur et si le paramètre a la ReferenceKind valeur wdNumberFullContext.)

SeparatorString
Object

Spécifie la chaîne à utiliser comme séparateur si le paramètre a la SeparateNumbers valeur true.

Exemples

L’exemple de code suivant ajoute un titre et du texte au document à l’aide Bookmark de contrôles, puis insère une référence croisée au texte du titre.

Cet exemple concerne une personnalisation au niveau du document.

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

Remarques

Si vous spécifiez wdPageNumber pour la valeur de ReferenceKind, vous devrez peut-être repaminer le document afin de voir les informations de référence croisée correctes.

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à