XMLNode (contrôle)XMLNode control

Important les informations mentionnées dans cette rubrique concernant Microsoft Word sont présentée exclusivement pour le bénéfice et l’utilisation des individus et les organisations qui se trouvent en dehors des États-Unis et ses territoires ou qui utilisent ou développement les programmes qui s’exécutent sur des produits de Microsoft Word qui ont été concédés sous licence par Microsoft avant janvier 2010, lorsque Microsoft supprimé une implémentation de fonctionnalités spécifiques liés à XML personnalisé à 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 être lues ou utilisées par les individus ou organisations dans les États-Unis ou dans ses territoires qui sont à l’aide d’ou de développer des programmes qui s’exécutent sur des produits de Microsoft Word qui ont été concédés 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 concédés sous licence pour une 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 devoir 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.

Lier des données au contrôleBind 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, le 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:

Comparer des événementsCompare 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 sur 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 elles sont toutes 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 le ContextEnter é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 montre les différences entre ces événements.The following table shows the differences between these events.

Sélectionnez l’é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 pour 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 de CompanyName à CompanyRegion, seule la ContextEnter événement pour CompanyRegion est déclenché, car vous êtes toujours 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

Éléments hôtes et la vue d’ensemble des contrôles hôtes Host items and host controls overview
Automatiser Word à l’aide d’objets étendus Automate 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 contrôles hôtesProgrammatic limitations of host items and host controls