Partager via


Bookmark.InsertCrossReference, méthode

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

  • 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

Voir aussi

Référence

Bookmark Interface

Microsoft.Office.Tools.Word, espace de noms