Bookmark.InsertCrossReference Metodo

Definizione

Spazio dei nomi:

Microsoft.Office.Tools.Word

Assembly:

Microsoft.Office.Tools.Word.dll

Inserisce un riferimento incrociato in un'intestazione, segnalibro, nota a piè di pagina o nota di chiusura oppure in un elemento per cui è definita un'etichetta di didascalia (ad esempio, un'equazione, figura o tabella) all'interno di un controllo Bookmark.

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)

Parametri

ReferenceType

Object

Tipo di elemento per cui deve essere inserito un riferimento incrociato. Può essere una costante WdReferenceType o WdCaptionLabelID oppure un'etichetta di didascalia definita dall'utente.

ReferenceKind

WdReferenceKind

Informazioni da includere nel riferimento incrociato.

ReferenceItem

Object

Se ReferenceType è wdRefTypeBookmark, questo argomento specifica un nome di segnalibro. Per tutti gli altri ReferenceType valori, questo argomento specifica il numero o il nome dell'elemento nella casella Tipo riferimento della finestra di dialogo Riferimento incrociato. Utilizzare il metodo GetCrossReferenceItems(Object) per restituire un elenco di nomi dell'elemento utilizzabile con questo argomento.

InsertAsHyperlink

Object

true per inserire il riferimento incrociato come collegamento ipertestuale all'elemento a cui si fa riferimento; in caso contrario, false.

IncludePosition

Object

true per effettuare l'inserimento sopra o sotto, a seconda della posizione dell'elemento di riferimento in relazione al riferimento incrociato.

SeparateNumbers

Object

true per utilizzare un separatore che separi i numeri dal testo associato Usare solo se il ReferenceType parametro è impostato su wdRefTypeNumberedItem e il ReferenceKind parametro è impostato su wdNumberFullContext.

SeparatorString

Object

Specifica la stringa da utilizzare come separatore se il SeparateNumbers parametro è impostato su true.

Esempio

Nell'esempio di codice seguente viene aggiunta un'intestazione e un testo al documento utilizzando Bookmark controlli e quindi viene inserito un riferimento incrociato al testo dell'intestazione.

Questo esempio è relativo a una personalizzazione a livello di documento.

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

Commenti

Se si specifica wdPageNumber per il valore di ReferenceKind, potrebbe essere necessario riginare il documento per visualizzare le informazioni di riferimento incrociato corrette.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.