Controllo Bookmark

Il controllo Microsoft.Office.Tools.Word.Bookmark è un segnalibro che presenta un nome univoco, espone eventi e può essere associato a dati.Può essere utilizzato come segnaposto per contrassegnare un elemento o una posizione in un documento di Microsoft Office Word.Il controllo Microsoft.Office.Tools.Word.Bookmark è una combinazione di un oggetto Microsoft.Office.Interop.Word.Bookmark e un oggetto Microsoft.Office.Interop.Word.Range.

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.

Nei progetti a livello di documento, è possibile aggiungere i controlli Microsoft.Office.Tools.Word.Bookmark al documento in fase di progettazione o di esecuzione.Nei progetti a livello di applicazione, è possibile aggiungere controlli Microsoft.Office.Tools.Word.Bookmark a qualsiasi documento aperto in fase di esecuzione.Per ulteriori informazioni, vedere Procedura: aggiungere controlli segnalibro ai documenti di Word.

Associazione di dati al controllo

Un controllo Microsoft.Office.Tools.Word.Bookmark supporta solo l'associazione dati semplice.Il segnalibro deve essere associato a un'origine dati mediante la proprietà DataBindings.La proprietà Text è la proprietà di associazione dati predefinita del segnalibro.

Se i dati nel dataset associato vengono aggiornati, il controllo Microsoft.Office.Tools.Word.Bookmark rifletterà tali modifiche.

Nei progetti a livello di documento, è anche possibile associare dati ai segnalibri utilizzando la finestra Origini dati.Per ulteriori informazioni, vedere Procedura: compilare documenti con dati da oggetti.

Formattazione

La formattazione applicabile a un controllo Microsoft.Office.Interop.Word.Bookmark può essere applicata anche a un controllo Microsoft.Office.Tools.Word.Bookmark,Nella formattazione sono inclusi tipi di carattere, rientri, spaziatura, numerazione e stili.

Assegnazione di testo al segnalibro

Un oggetto Microsoft.Office.Interop.Word.Bookmark inoltre si differenzia da un controllo Microsoft.Office.Tools.Word.Bookmark nel comportamento assunto quando si assegna del testo al segnalibro.Se si assegna del testo a un oggetto Microsoft.Office.Interop.Word.Bookmark di lunghezza zero, il testo viene aggiunto a destra del segnalibro e quest'ultimo resta di lunghezza zero.Se invece si assegna del testo a un controllo Microsoft.Office.Tools.Word.Bookmark di lunghezza zero, il testo viene inserito nel segnalibro e la lunghezza del segnalibro viene aumentata in base al numero totale di caratteri inseriti.

Il controllo Microsoft.Office.Tools.Word.Bookmark dispone anche della proprietà Bookmark.Text.Questa proprietà è diversa dalla proprietà Range.Text disponibile nella proprietà Range di un controllo Microsoft.Office.Tools.Word.Bookmark o nella proprietà Range di un oggetto Microsoft.Office.Interop.Word.Bookmark.

Proprietà Text	Descrizione
Bookmark.Text	Utilizzare questa proprietà per visualizzare il testo all'interno del segnalibro e lasciare il segnalibro nel documento.Con l'assegnazione di testo, l'intervallo del segnalibro si espande e il segnalibro non viene eliminato. Con Bookmark1.Text = "Hello world", ad esempio, si inserisce del testo nel segnalibro e si lascia intatto il segnalibro.
Range.Text	Utilizzare questa proprietà per visualizzare del testo in corrispondenza del segnalibro ed eliminare automaticamente il segnalibro.Con Bookmark1.Range.Text = "Hello world", ad esempio si inserisce del testo nel segnalibro e si elimina il segnalibro.

Ridenominazione del controllo in fase di progettazione

Nei progetti a livello di documento, quando si trascina un controllo Microsoft.Office.Tools.Word.Bookmark dalla casella degli strumenti al documento, in Visual Studio viene generato automaticamente un nome per il controllo.È possibile modificare il nome del controllo nella finestra Proprietà.

Sovrapposizione di controlli

I controlli Bookmark possono sovrapporsi, ovvero lo stesso testo può essere condiviso da più segnalibri.Quando si assegna nuovo testo a uno dei segnalibri sovrapposti, quest'ultimo conterrà solo il nuovo testo e i segnalibri non saranno più sovrapposti.L'altro segnalibro conterrà invece solo il testo originariamente non condiviso tra i segnalibri sovrapposti.

Nella tabella riportata di seguito è illustrato un esempio di condivisione della frase “This is sample text.” tra due segnalibri sovrapposti.

Segnalibro	Testo
Segnalibri sovrapposti	[this is {sample] text.}
Bookmark1	This is sample
Bookmark2	sample text.

Se si assegna il nuovo testo "This is replacement." a Bookmark1, i segnalibri non saranno più sovrapposti e Bookmark2 conserverà solo il testo che originariamente non faceva parte di Bookmark1.

Segnalibro	Testo
Due segnalibri separati	[this is replacement]{ text.}
Bookmark1	This is replacement
Bookmark2	text.

Se un segnalibro è interamente contenuto in un altro segnalibro e il testo del segnalibro esterno viene modificato, quello interno non viene eliminato;diventa invece un segnalibro vuoto che viene spostato alla fine del segnalibro esterno.Nella tabella riportata di seguito è illustrato un esempio di condivisione della frase “This is sample text.” tra un segnalibro e il segnalibro che lo contiene.

Segnalibro	Testo
Segnalibri sovrapposti	[this is {sample} text.]
Bookmark1	This is sample text.
Bookmark2	esempio

Se si assegna il nuovo testo "This is replacement." a Bookmark1, i segnalibri non saranno più sovrapposti e Bookmark2 diventa un segnalibro vuoto posto alla fine di Bookmark1.

Segnalibro	Testo
Due segnalibri separati	[this is replacement.]{}
Bookmark1	This is replacement.
Bookmark2	<vuoto>

Eventi

Per il controllo Microsoft.Office.Tools.Word.Bookmark sono disponibili gli eventi seguenti:

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Deselected

• Disposed

• Selected

• SelectionChange

Vedere anche

Attività

Procedura: aggiungere controlli segnalibro ai documenti di Word

Procedura dettagliata: creazione di menu di scelta rapida per segnalibri

Concetti

Automazione di Word utilizzando oggetti estesi

Limitazioni a livello di codice degli elementi e dei controlli host

Altre risorse

Associazione di dati ai controlli nelle soluzioni Office