Controllo XMLNodes

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 XMLNodes è un insieme di oggetti nodo XML mappati che espone eventi. Il controllo XMLNodes viene creato solo quando un elemento ripetuto dello schema viene mappato in un documento di Microsoft Office Word. Se l'elemento ripetuto contiene elementi figlio, questi verranno creati come controlli XMLNodes.

Una volta che Visual Studio ha creato l'insieme di nodi XML è possibile eseguire la programmazione per il controllo direttamente, senza dover passare al modello a oggetti di Word. Il controllo XMLNodes può essere eliminato solo rimuovendo il mapping dell'elemento dal documento.

Nota

Se si accede a un elemento figlio del controllo XMLNodes mediante la proprietà Item, viene restituito un oggetto Microsoft.Office.Interop.Word.XMLNode invece di un controllo Microsoft.Office.Tools.Word.XMLNode. Per ulteriori informazioni, vedere Limitazioni a livello di codice degli elementi e dei controlli host.

Associazione di dati al controllo

Un controllo XMLNodes non supporta l'associazione dati. Questa condizione si verifica perché il controllo XMLNodes non dispone della funzionalità di associazione dati complessa e l'associazione dati semplice non è in grado di rappresentare i dati ripetuti.

Formattazione

La formattazione che è possibile applicare al testo all'interno del documento può essere applicata a un controllo XMLNodes.

Eventi

Gli eventi disponibili per il controllo XMLNodes sono:

Confronto di eventi

È possibile acquisire un evento quando l'utente sposta il cursore nel contesto di un particolare controllo XMLNodes. Ad esempio, è possibile disporre di un controllo XMLNodes denominato Customer che dispone di un controllo figlio XMLNodes denominato Company e di un controllo Company che dispone di due controlli figlio XMLNodes 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 XMLNodes, 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 viene posizionato all'interno di uno dei nodi dell'insieme XMLNodes.	Viene generato quando il cursore viene posizionato in uno dei nodi o dei nodi di discendente dell'insieme XMLNodes, da un'area esterna del contesto del nodo. In altre parole, l'evento viene generato solo quando il contesto cambia e può essere generato per più controlli XMLNodes annidati.

Ad esempio, quando si sposta il cursore da Customer a CompanyName, vengono generati gli eventi 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 contesto di Company e Customer è uguale. Nel documento possono essere presenti più nodi Company. Se si sposta il cursore dal nodo CompanyName di un nodo Company al nodo CompanyName di un altro nodo Company, il contesto è lo stesso, per cui viene generato solo l'evento Select.

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