Bookmark (controllo)
Il controllo Bookmark è un segnalibro con un nome univoco che espone gli eventi e può essere associato ai dati. Può essere usato come segnaposto per contrassegnare un elemento o una posizione in un documento di Microsoft Office Word. Il controllo Bookmark è una combinazione degli oggetti Bookmark e Range .
Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.
Nei progetti a livello di documento è possibile aggiungere i controlli Bookmark al documento in fase di progettazione o di esecuzione. Nei progetti di componente aggiuntivo VSTO è possibile aggiungere i controlli Bookmark a qualsiasi documento aperto in fase di esecuzione. Per altre informazioni, vedere Procedura: Aggiungere controlli Segnalibro ai documenti di Word.
Associare i dati al controllo
Un controllo Bookmark supporta un data binding semplice. Il segnalibro deve essere associato a un'origine dati usando la proprietà DataBindings . La proprietà di data binding predefinita del segnalibro è Text .
Se i dati nel set di dati associato vengono aggiornati, il Bookmark controllo mostra le modifiche.
Nei progetti a livello di documento è anche possibile associare i dati ai segnalibri usando la finestra Origini dati . Per altre informazioni, vedere Procedura: Popolare documenti con dati da oggetti.
Formattazione in corso
La formattazione applicabile a Bookmark può essere applicata anche a un controllo Bookmark . Questa formattazione include tipi di carattere, rientri, spaziatura, numerazione e stili.
Assegnare testo al segnalibro
Un'altra differenza tra un oggetto Microsoft.Office.Interop.Word.Bookmark e un controllo Microsoft.Office.Tools.Word.Bookmark riguarda il comportamento tenuto quando viene assegnato un testo al segnalibro. Se si assegna un testo a un oggetto Microsoft.Office.Interop.Word.Bookmarkdi lunghezza zero, il testo viene aggiunto alla destra del segnalibro e il segnalibro resta di lunghezza zero. Tuttavia, se si assegna un testo a un controllo Microsoft.Office.Tools.Word.Bookmarkdi lunghezza zero, il testo viene inserito nel segnalibro e la lunghezza del segnalibro aumenta per il numero totale di caratteri inseriti.
Il controllo Microsoft.Office.Tools.Word.Bookmark ha anche la proprietà Bookmark.Text , Questa proprietà è diversa dalla Range.Text proprietà disponibile nella Bookmark.Range proprietà di un Microsoft.Office.Tools.Word.Bookmark controllo o dalla Bookmark.Range proprietà di un Microsoft.Office.Interop.Word.Bookmark oggetto .
| Proprietà Text | Descrizione |
|---|---|
| Bookmark.Text | Usare questa proprietà per visualizzare un testo nel segnalibro e lasciare il segnalibro nel documento. L'assegnazione di un testo al segnalibro espande l'intervallo del segnalibro senza eliminarlo. Ad esempio, Bookmark1.Text = "Hello world" inserisce il testo nel segnalibro e lascia intatto il segnalibro. |
| Range.Text | Usare questa proprietà per visualizzare il testo in corrispondenza del segnalibro ed eliminare automaticamente il segnalibro. Ad esempio, Bookmark1.Range.Text = "Hello world" inserisce il testo nel segnalibro ed elimina il segnalibro. |
Rinominare il controllo in fase di progettazione
Nei progetti a livello di documento, quando si trascina un controllo Bookmark dalla casella degli strumenti al documento, Visual Studio genera automaticamente un nome per il controllo, che può essere modificato nella finestra Proprietà .
Controlli sovrapposti
I controlli segnalibro possono sovrapporsi tra loro. Lo stesso testo può essere condiviso da più segnalibri. Quando si assegna nuovo testo a uno dei segnalibri sovrapposti, contiene solo il nuovo testo e i segnalibri non si sovrappongono più. L'altro segnalibro contiene ora solo il testo non condiviso tra i segnalibri sovrapposti originali.
Nella tabella seguente viene illustrato il modo in cui la frase "Questo è testo di esempio". Viene condivisa da due segnalibri sovrapposti:
| Segnalibro | Testo |
|---|---|
| Segnalibri sovrapposti | [this is {sample] text.} |
| Segnalibro1 | This is sample |
| Segnalibro2 | sample text. |
Se si assegna il nuovo testo "Questa sostituzione." a Bookmark1, i segnalibri non si sovrappongono e Bookmark2 mantiene solo il testo che non fa parte originariamente di Bookmark1.
| Segnalibro | Testo |
|---|---|
| Due segnalibri separati | [this is replacement]{ text.} |
| Segnalibro1 | This is replacement |
| Segnalibro2 | text. |
Se si modifica il testo di un segnalibro che contiene un altro segnalibro, il segnalibro interno non viene eliminato. Tuttavia, il segnalibro interno diventa un segnalibro vuoto e si sposta alla fine del segnalibro esterno.
La tabella seguente illustra come la frase "Questo è testo di esempio". Viene condivisa da un segnalibro contenuto in un altro segnalibro:
| Segnalibro | Testo |
|---|---|
| Segnalibri sovrapposti | [this is {sample} text.] |
| Segnalibro1 | This is sample text. |
| Segnalibro2 | sample |
Se si assegna il nuovo testo "Questa sostituzione." a Bookmark1, i segnalibri non sono più sovrapposti e Bookmark2 diventa un segnalibro vuoto che si trova alla fine di Bookmark1.
| Segnalibro | Testo |
|---|---|
| Due segnalibri separati | [questa è la sostituzione.]{} |
| Segnalibro1 | This is replacement. |
| Segnalibro2 | <empty> |
Eventi
Gli eventi seguenti sono disponibili per il controllo Bookmark :