XMLNode, contrôleXMLNode Control

Important les informations mentionnées dans cette rubrique concernant Microsoft Word sont présenté exclusivement pour le bénéfice et l’utilisation des personnes et des organisations qui se trouvent en dehors des États-Unis et ses territoires ou qui sont à l’aide d’ou de développement programmes qui s’exécutent sur des produits de Microsoft Word qui ont été concédé sous licence par Microsoft avant de janvier 2010, lorsque Microsoft supprimé une implémentation de fonctionnalités spécifiques liées à XML personnalisées à partir de Microsoft Word.Important The information set out in this topic regarding Microsoft Word is presented exclusively for the benefit and use of individuals and organizations who are located outside the United States and its territories or who are using, or developing programs that run on, Microsoft Word products that were licensed by Microsoft before January 2010, when Microsoft removed an implementation of particular functionality related to custom XML from Microsoft Word. Ces informations concernant Microsoft Word ne peuvent pas lire ou utilisées par des individus ou organisations États-Unis ou dans ses territoires qui utilisent, ou développent des programmes qui s’exécutent sur des produits de Microsoft Word qui ont été concédé sous licence par Microsoft après le 10 janvier 2010 ; ces produits ne comportent pas le même que les produits sous licence avant cette date ou acheté et une licence d’utilisation en dehors des États-Unis.This information regarding Microsoft Word may not be read or used by individuals or organizations in the United States or its territories who are using, or developing programs that run on, Microsoft Word products that were licensed by Microsoft after January 10, 2010; those products will not behave the same as products licensed before that date or purchased and licensed for use outside the United States.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document pour Word.Applies to: The information in this topic applies to document-level projects for Word. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Le XMLNode contrôle est un objet de nœud XML mappé qui expose des événements et peut être lié aux données.The XMLNode control is a mapped XML node object that exposes events and can be bound to data. Le XMLNode contrôle est créé uniquement lorsqu’un élément de schéma non répétitif est mappé à un document Microsoft Office Word.The XMLNode control is created only when a non-repeating schema element is mapped onto a Microsoft Office Word document. Une fois que Visual Studio crée le nœud XML, vous pouvez le programmer directement sans avoir à parcourir le modèle objet Word.After Visual Studio creates the XML node, you can program against it directly without having to traverse the Word object model.

Le XMLNode contrôle peut être supprimé uniquement en supprimant le mappage d’élément dans Word.The XMLNode control can be deleted only by removing the element mapping in Word.

Liaison de données au contrôleBinding Data to the Control

Un XMLNode contrôle prend en charge la liaison de données simple.An XMLNode control supports simple data binding. Le nœud XML doit être lié à une source de données à l’aide de la DataBindings propriété.The XML node should be bound to a data source by using the DataBindings property. Si les données du DataSet lié sont mis à jour, la XMLNode contrôle reflète les modifications.If the data in the bound dataset is updated, the XMLNode control reflects the changes.

Mise en formeFormatting

Mise en forme qui peut être appliqué à un XMLNode objet peut être appliqué à un XMLNode contrôle.Formatting that can be applied to a XMLNode object can be applied to a XMLNode control. Cela inclut les polices, des styles de soulignement et des styles de caractère.This includes fonts, underline styles, and character styles.

ÉvénementsEvents

Les événements suivants sont disponibles pour le contrôle XMLNode :The following events are available for the XMLNode control:

Événements de comparaisonComparing Events

Vous pouvez capturer un événement lorsque l’utilisateur déplace son curseur dans le contexte d’un particulier XMLNode contrôle.You can capture an event when the user moves his or her cursor inside the context of a particular XMLNode control. Par exemple, vous pouvez avoir un XMLNode contrôle nommé Customer qui a un enfant XMLNode contrôle nommé Company, et Company a deux enfants XMLNode contrôles nommés CompanyName et CompanyRegion comme suit :For example, you might have an XMLNode control named Customer that has a child XMLNode control named Company, and Company has two child XMLNode controls named CompanyName and CompanyRegion as follows:

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

Si vous souhaitez afficher un contrôle dans le volet actions chaque fois que le curseur est déplacé dans le Company nœud, il importe peu que le curseur est placé dans CompanyName ou CompanyRegion car ils sont tous deux dans le contexte de Company.If you want to show a control on the actions pane whenever the cursor is moved into the Company node, it should not matter whether the cursor is placed in CompanyName or CompanyRegion because they are both within the context of Company. Dans ce cas, vous pouvez écrire votre code dans le ContextEnter l’événement de Company.In this case, you can write your code in the ContextEnter event of Company.

Dans la plupart des cas, lorsque le curseur passe un XMLNode contrôler, à la fois le Select et ContextEnter sont déclenchés.In most cases, when the cursor enters an XMLNode control, both the Select and ContextEnter events are raised. Le tableau suivant indique les différences entre ces événements.The following table shows the differences between these events.

Sélectionnez un événementSelect Event Événement ContextEnterContextEnter Event
Se produit lorsque le curseur est placé à l’intérieur d’un XMLNode.Occurs when the cursor is placed inside an XMLNode. Se produit lorsque le curseur est placé à l’intérieur d’un XMLNode ou l’un de ses nœuds descendants, à partir d’une zone en dehors du contexte du nœud.Occurs when the cursor is placed inside an XMLNode or one of its descendent nodes, from an area outside of the context of the node. En d’autres termes, il est déclenché uniquement lorsque le contexte change.In other words, it is raised only when the context changes.

Par exemple, lorsque vous déplacez le curseur en dehors de Customer dans CompanyName, le ContextEnter événement Customer, Company, et CompanyName est déclenché.For example, when you move the cursor from outside of Customer into CompanyName, the ContextEnter event for Customer, Company, and CompanyName is raised. Si vous déplacez ensuite le curseur à partir de CompanyName à CompanyRegion, seule la ContextEnter événement pour CompanyRegion est déclenché, car vous êtes encore dans le contexte des deux Company et Customer.If you then move the cursor from CompanyName to CompanyRegion, only the ContextEnter event for CompanyRegion is raised because you are still within the context of both Company and Customer.

Les mêmes différences existent entre les ContextLeave événement et Deselect événement.The same differences exist between the ContextLeave event and Deselect event.

Voir aussiSee Also

Vue d'ensemble des éléments hôtes et des contrôles hôtes Host Items and Host Controls Overview
Automatisation de Word à l’aide d’objets étendus Automating Word by Using Extended Objects
XMLNodes (contrôle) XMLNodes Control
Comment : ajouter des contrôles XMLNode à des Documents Word How to: Add XMLNode Controls to Word Documents
Comment : mapper des schémas à des Documents Word dans Visual Studio How to: Map Schemas to Word Documents Inside Visual Studio
Limitations de programmation des éléments hôtes et des contrôles hôtesProgrammatic Limitations of Host Items and Host Controls