XMLNodes, contrôle

Article
03/04/2013

important les informations présentées dans cette rubrique concernant Microsoft Word est présenté exclusivement pour l'avantage et l'utilisation des personnes et organisations qui se trouvent en dehors de les états-unis et de ses territoires ou qui utilisent, ou de développer des programmes qui s'exécutent sur, les produits Microsoft Word qui ont été autorisés par Microsoft avant janvier 2010, lorsque Microsoft a supprimé une implémentation de fonctionnalités spécifique liée à une personnalisée XML Microsoft Word.Ces informations liées à Microsoft Word ne peuvent pas être lues ou utilisées par des individus ou des organisations se trouvant aux États-Unis ou dans ses territoires qui utilisent, ou développent des programmes exécutés avec, des produits Microsoft Word dont la licence Microsoft est postérieure à janvier 2010 ; ces produits n'auront pas le même comportement que ceux dont la licence est antérieure à cette date ou ceux qui ont été achetés ou ont bénéficié d'une licence d'utilisation en dehors des États-Unis.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour Word 2013 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Le contrôle XMLNodes est une collection d'objets de nœud XML mappés qui expose des événements.Le contrôle XMLNodes est créé uniquement lorsqu'un élément de schéma répétitif est mappé à un document Microsoft Office Word.Si l'élément répétitif contient des éléments enfants, chacun des éléments enfants est également créé en tant que contrôle XMLNodes.

Une fois que Visual Studio a créé la collection de nœuds XML, vous pouvez effectuer des programmations directement sur ce contrôle sans devoir parcourir le modèle objet Word.Le contrôle XMLNodes peut uniquement être supprimé en supprimant le mappage d'élément dans le document.

[!REMARQUE]

Si vous accédez à un élément enfant du contrôle XMLNodes via la propriété Item, un objet Microsoft.Office.Interop.Word.XMLNode est retourné, plutôt qu'un contrôle Microsoft.Office.Tools.Word.XMLNode.Pour plus d’informations, consultez Limitations de programmation des éléments hôtes et des contrôles hôtes.

Liaison de données au contrôle

Un contrôle XMLNodes ne prend pas en charge la liaison de données.En effet, le contrôle XMLNodes ne dispose pas de fonctions de liaison de données complexes, et la liaison de données simple ne peut pas représenter des données répétitives.

Mise en forme

Toute mise en forme qui peut être appliquée à du texte dans le document peut être appliquée à un contrôle XMLNodes.

Événements

Les événements disponibles pour le contrôle XMLNodes sont les suivants :

Événements de comparaison

Vous pouvez capturer un événement lorsque l'utilisateur déplace son curseur à l'intérieur du contexte d'un contrôle XMLNodes particulier.Par exemple, vous pouvez avoir un contrôle XMLNodes nommé Customer qui possède un contrôle XMLNodes enfant nommé Company, et Company a deux contrôles XMLNodes enfants nommés CompanyName et CompanyRegion comme suit :

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

Si vous souhaitez afficher un contrôle sur le volet Actions chaque fois que le curseur est déplacé dans le nœud Company, le fait que le curseur soit placé dans CompanyName ou CompanyRegion n'a pas d'importance car ils sont tous deux dans le contexte de Company.Dans ce cas, vous pouvez écrire votre code dans l'événement ContextEnter de Company.

Dans la plupart des cas, lorsque le curseur entre dans un contrôle XMLNodes, les événements Select et ContextEnter sont déclenchés.Le tableau ci-dessous indique les différences entre ces événements.

Événement Select	Événement ContextEnter
Se produit lorsque le curseur est placé à l'intérieur de l'un des nœuds de la collection XMLNodes.	Se produit lorsque le curseur est placé à l'intérieur de l'un des nœuds ou des nœuds descendants de la collection XMLNodes, à partir d'une zone en dehors du contexte du nœud.En d'autres termes, il est déclenché uniquement lorsque le contexte change et peut être déclenché pour plusieurs contrôles XMLNodes imbriqués.

Par exemple, lorsque vous déplacez le curseur situé en dehors de Customer dans CompanyName, les événements ContextEnter pour Customer, Company et CompanyName sont déclenchés.Si vous déplacez ensuite le curseur de CompanyName vers CompanyRegion, l'événement ContextEnter est déclenché pour CompanyRegion uniquement, car le contexte est identique pour Company et Customer.Votre document peut comporter plusieurs nœuds Company.Si vous déplacez le curseur à partir du nœud CompanyName d'un nœud Company vers le nœud CompanyName d'un autre nœud Company, le contexte est le même. Par conséquent, seul l'événement Select est déclenché.

Les mêmes différences existent entre les événements ContextLeave et Deselect.