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 2007 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	Text
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.

Bookmark	Text
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	Text
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	Text
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