Metodo Bookmark.InsertCrossReference

Articolo
05/17/2013

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.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

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

Parametri

ReferenceType
Tipo: System.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
Tipo: Microsoft.Office.Interop.Word.WdReferenceKind
Informazioni da includere nel riferimento incrociato.

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

InsertAsHyperlink
Tipo: System.Object%
true per inserire il riferimento incrociato come collegamento ipertestuale all'elemento a cui si fa riferimento; in caso contrario, false.

IncludePosition
Tipo: System.Object%
true per effettuare l'inserimento sopra o sotto, a seconda della posizione dell'elemento di riferimento in relazione al riferimento incrociato.

SeparateNumbers
Tipo: System.Object%
true per utilizzare un separatore che separi i numeri dal testo associato(utilizzare solo se il parametro ReferenceType è impostato su wdRefTypeNumberedItem e il parametro ReferenceKind è impostato su wdNumberFullContext).

SeparatorString
Tipo: System.Object%
Specifica la stringa da utilizzare come separatore se il parametro SeparateNumbers è impostato su true.

Note

Se si specifica wdPageNumber per il valore di ReferenceKind, potrebbe essere necessaria la rimpaginazione del documento per poter visualizzare le corrette informazioni sul riferimento incrociato.

Parametri facoltativi

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

Esempi

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

Questo esempio è valido per una personalizzazione a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Bookmark Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite