Procedura: aggiornare il testo del segnalibro

Articolo
04/28/2010

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Progetti a livello di applicazione Versione Microsoft Office Word 2003 Word 2007 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di documento
Progetti a livello di applicazione

Versione Microsoft Office

Word 2003
Word 2007

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

È possibile inserire un testo in un segnalibro di un documento Microsoft Office Word in modo da recuperare il testo in un secondo momento oppure sostituirlo. Se si sta sviluppando una personalizzazione a livello di documento, è anche possibile aggiornare il testo in un controllo Microsoft.Office.Tools.Word.Bookmark associato ai dati. Per ulteriori informazioni, vedere Associazione di dati ai controlli.

L'oggetto Bookmark può essere di due tipi:

Un controllo host Microsoft.Office.Tools.Word.Bookmark.

I controlli Microsoft.Office.Tools.Word.Bookmark estendono gli oggetti nativi Microsoft.Office.Interop.Word.Bookmark attivando l'associazione dati ed esponendo eventi. Per ulteriori informazioni sui controlli host, vedere Cenni preliminari sugli elementi e sui controlli host.
Un oggetto Microsoft.Office.Interop.Word.Bookmark nativo.

Gli oggetti Microsoft.Office.Interop.Word.Bookmark non espongono eventi e non consentono l'associazione dati.

Quando si assegna testo a un segnalibro, il comportamento dell'oggetto Microsoft.Office.Interop.Word.Bookmark differisce da quello dell'oggetto Microsoft.Office.Tools.Word.Bookmark. Per ulteriori informazioni, vedere Controllo Bookmark.

Utilizzo di controlli host

Per aggiornare i contenuti dei segnalibri mediante il controllo Bookmark

Creare una routine che accetti l'argomento bookmark per il nome del segnalibro e un argomento newText per la stringa che assegna la proprietà Text.

Nota:
L'assegnazione di testo alla proprietà Bookmark.Text o alla proprietà Bookmark.FormattedText di un controllo Microsoft.Office.Tools.Word.Bookmark non determina l'eliminazione del segnalibro.

Shared Sub BookMarkReplace( _
    ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
    ByVal newText As String)

static void BookMarkReplace(
    ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
    string newText)
{

Assegnare la stringa newText alla proprietà Text dell'oggetto Microsoft.Office.Tools.Word.Bookmark.
```
    bookmark.Text = newText
End Sub
```
```
    bookmark.Text = newText;
}
```

Utilizzo di oggetti di Word

Per aggiornare i contenuti dei segnalibri mediante un oggetto Bookmark di Word

Creare una routine con l'argomento bookmark per Microsoft.Office.Interop.Word.Bookmark e un argomento newText per la stringa che assegna la proprietà Range.Text del segnalibro.

Nota:

L'assegnazione di testo a un oggetto nativo di Word Microsoft.Office.Interop.Word.Bookmark provoca l'eliminazione del segnalibro.
```
Friend Sub BookMarkReplaceNative( _
    ByVal bookmark As Word.Bookmark, _
    ByVal newText As String)
```
```
internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{
```

Nota:
L'assegnazione di testo a un oggetto nativo di Word Microsoft.Office.Interop.Word.Bookmark provoca l'eliminazione del segnalibro.

Assegnare la stringa newText alla proprietà Range.Text del segnalibro che automaticamente elimina il segnalibro. Aggiungere nuovamente il segnalibro all'insieme Bookmarks.

L'esempio di codice seguente può essere utilizzato in una personalizzazione a livello di documento.

    Dim rng As Word.Range = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText

    Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    this.Bookmarks.Add(bookmarkName, ref rng); 
}

L'esempio di codice seguente può essere utilizzato in un componente aggiuntivo a livello di applicazione. In questo esempio viene utilizzato il documento attivo.

    Dim rng As Object = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText
    Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    Word.Document document = this.Application.ActiveDocument;
    document.Bookmarks.Add(bookmarkName, ref rng);
}

Vedere anche

Attività

Procedura: inserire testo nei documenti di Word

Concetti

Cenni preliminari sul modello a oggetti di Word

Controllo Bookmark

Condividi tramite