Controllo Bookmark
Aggiornamento: Luglio 2008
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. Progetti a livello di documento
Progetti a livello di applicazione
Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione. |
Il controllo Bookmark è un segnalibro che dispone di 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 Bookmark è una combinazione di un oggetto Microsoft.Office.Interop.Word.Bookmark e un oggetto Microsoft.Office.Interop.Word.Range. Quando si aggiunge un segnalibro a un documento, Visual Studio Tools per Office crea un oggetto Bookmark per il quale è possibile eseguire la programmazione diretta senza che sia necessario passare al modello a oggetti di Word.
Nei progetti a livello di documento, è possibile aggiungere i controlli Bookmark al documento in fase di progettazione o di esecuzione. A partire da Visual Studio 2008 Service Pack 1 (SP1), l'aggiunta di controlli Bookmark può essere effettuata anche in fase di esecuzione a qualsiasi documento aperto, utilizzando un componente aggiuntivo a livello di applicazione per Word 2007. Per ulteriori informazioni, vedere Procedura: aggiungere controlli segnalibro ai documenti di Word.
Associazione di dati al controllo
Un controllo 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 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 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 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 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.
Visual Studio Tools per Office aggiunge inoltre una proprietà Bookmark.Text al controllo Bookmark. Questa è diversa dalla proprietà Range.Text disponibile nel controllo Range del segnalibro.
Proprietà Text |
Descrizione |
|---|---|
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. |
|
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 Bookmark dalla Casella degli strumenti al documento, in Visual Studio Tools per Office 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.
Bookmark |
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.
Bookmark |
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.
Bookmark |
Text |
|---|---|
Due segnalibri separati |
[this is replacement.]{} |
Bookmark1 |
This is replacement. |
Bookmark2 |
<vuoto> |
Eventi
Per il controllo Bookmark sono disponibili gli eventi seguenti:
Vedere anche
Attività
Procedura: aggiungere controlli segnalibro ai documenti di Word
Procedura dettagliata: creazione di menu di scelta rapida per segnalibri
Concetti
Associazione di dati ai controlli
Limitazioni a livello di codice degli elementi e dei controlli host
Altre risorse
Cronologia delle modifiche
Date |
History |
Motivo |
|---|---|---|
|
Luglio 2008 |
Aggiunte informazioni sull'utilizzo dei controlli segnalibro nei progetti a livello di applicazione. |
Modifica di funzionalità in SP1. |