Procedura: aggiornare testo di segnalibro a livello di codice
È 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 nelle soluzioni Office.
Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Word 2013 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.
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 abilitando 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) {
Assegnare la stringa newText alla proprietà Range.Text del segnalibro che automaticamente elimina il segnalibro.Aggiungere nuovamente il segnalibro alla raccolta 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 a livello di codice