Bookmark.InsertCrossReference, méthode

Article
01/06/2014

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

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
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
)

Paramètres

ReferenceType
Type : System.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
Type : Microsoft.Office.Interop.Word.WdReferenceKind
Informations à inclure dans le renvoi.

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

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

IncludePosition
Type : System.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
Type : System.Object%
true pour utiliser un séparateur entre les numéros et le texte associé. (À utiliser uniquement si le paramètre ReferenceType a la valeur wdRefTypeNumberedItem et le paramètre ReferenceKind a la valeur wdNumberFullContext.)

SeparatorString
Type : System.Object%
Spécifie la chaîne à utiliser comme séparateur si le paramètre SeparateNumbers a la valeur true.

Notes

Si vous donnez la valeur wdPageNumber au ReferenceKind, vous aurez peut-être à repaginer le document pour voir les renvois corrects.

Paramètres optionnels

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

Exemples

L'exemple de code suivant ajoute un titre et du texte au document à l'aide des contrôles Bookmark, puis insère un renvoi au texte d'en-tête.

Cet exemple illustre une personnalisation au niveau du document.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

Bookmark Interface

Microsoft.Office.Tools.Word, espace de noms

Partager via