Controllo XMLNode

Articolo
08/11/2011

Importante Le informazioni relative a Microsoft Word fornite in questo argomento vengono presentate esclusivamente a vantaggio e uso degli individui e delle organizzazioni che si trovano all'esterno degli Stati Uniti e dei relativi territori oppure che usano o sviluppano programmi eseguiti con prodotti Microsoft Word concessi in licenza da Microsoft prima del gennaio 2010, quando Microsoft ha rimosso da Microsoft Word un'implementazione di una determinata funzionalità correlata a XML personalizzato. Queste informazioni relative a Microsoft Word non possono essere lette o utilizzate dagli individui o delle organizzazioni che si trovano negli Stati Uniti o nei relativi territori oppure che usano o sviluppano programmi eseguiti con prodotti Microsoft Word concessi in licenza da Microsoft dopo il 10 gennaio 2010. Questi prodotti funzioneranno in modo diverso rispetto a quelli concessi in licenza prima di tale data oppure acquistati e concessi in licenza per l'uso all'esterno degli Stati Uniti.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Il controllo XMLNode rappresenta un nodo XML mappato che espone eventi e può essere associato a dati. Il controllo XMLNode viene creato solo quando un elemento non ripetuto dello schema viene mappato in un documento di Microsoft Office Word. Una volta che Visual Studio ha creato il nodo XML è possibile eseguire la programmazione per questo oggetto in modo diretto, senza dover passare al modello a oggetti di Word.

Il controllo XMLNode può essere eliminato solo rimuovendo il mapping dell'elemento in Word.

Associazione di dati al controllo

Un controllo XMLNode supporta solo l'associazione dati semplice. Il nodo XML deve essere associato a un'origine dati tramite la proprietà DataBindings. Se i dati nel dataset associato vengono aggiornati, il controllo XMLNode rifletterà tali modifiche.

Formattazione

La formattazione applicabile a un oggetto Microsoft.Office.Interop.Word.XMLNode può essere applicata anche a un controllo Microsoft.Office.Tools.Word.XMLNode. Sono inclusi i tipi di carattere, gli stili di sottolineatura e gli stili dei caratteri.

Eventi

I seguenti eventi sono disponibili per il controllo XMLNode:

Confronto di eventi

È possibile acquisire un evento quando l'utente sposta il cursore nel contesto di un particolare controllo XMLNode. Ad esempio, è possibile disporre di un controllo XMLNode denominato Customer che dispone di un controllo figlio XMLNode denominato Company e di un controllo Company che dispone di due controlli figlio XMLNode denominati CompanyName e CompanyRegion come illustrato di seguito.

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

Se si desidera visualizzare un controllo nel riquadro delle azioni ogni volta che il cursore viene spostato nel nodo Company, la posizione del cursore in CompanyName o in CompanyRegion non è determinante, poiché questi due controlli sono entrambi nel contesto di Company. In questo caso, il codice può essere creato nell'evento ContextEnter di Company.

Nella maggior parte dei casi, quando il cursore è spostato su un controllo XMLNode, vengono generati gli eventi Select e ContextEnter. Nella tabella che segue sono illustrate le differenze tra questi eventi.

Evento Select	Evento ContextEnter
Viene generato quando il cursore è posizionato all'interno di un controllo XMLNode.	Viene generato quando il cursore viene posizionato in un nodo XMLNode o in uno dei nodi figlio, da un'area esterna dal contesto del nodo. In altre parole, viene generato solo quando il contesto cambia.

Ad esempio, quando si sposta il cursore da Customer a CompanyName, viene generato l'evento ContextEnter per Customer, Company e CompanyName. Se poi si sposta il cursore da CompanyName a CompanyRegion, viene generato solo l'evento ContextEnter per CompanyRegion, in quanto il cursore rimane nel contesto di Company e Customer.

Le stesse differenze distinguono l'evento ContextLeave dall'evento Deselect.