Partager via


XMLNode, contrôle

Mise à jour : novembre 2007

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

  • Projets au niveau du document

Version de Microsoft Office

  • Word 2007

  • Word 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Le contrôle XMLNode est un objet de nœud XML mappé qui expose des événements et peut être lié aux données. Le contrôle XMLNode est créé uniquement lorsqu'un élément de schéma non répétitif est mappé à un document Microsoft Office Word. Après que Visual Studio Tools pour Office ait créé le nœud XML, vous pouvez le programmer directement sans devoir parcourir le modèle objet Word.

Le contrôle XMLNode ne peut être supprimé qu'en retirant le mappage d'élément dans Word.

Liaison de données au contrôle

Un contrôle XMLNode prend en charge la liaison de données simple. Le nœud XML doit être lié à une source de données à l'aide de la propriété DataBindings. Si les données du groupe de données lié sont mises à jour, les modifications sont répercutées dans le contrôle XMLNode.

Mise en forme

Une mise en forme qui peut être appliquée à un objet Microsoft.Office.Interop.Word.XMLNode peut être appliquée à un contrôle Microsoft.Office.Tools.Word.XMLNode. Cela inclut les polices, les styles de soulignement et les styles de caractères.

Événements

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

É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 XMLNode particulier. Par exemple, vous pouvez avoir un contrôle XMLNode nommé Customer qui possède un contrôle XMLNode enfant nommé Company, et Company a deux contrôles XMLNode 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 XMLNode, les événements Select et ContextEnter sont déclenchés. Le tableau suivant montre les différences entre ces événements.

Événement de sélection

Événement ContextEnter

Se produit lorsque le curseur est placé à l'intérieur d'un XMLNode.

Se produit lorsque le curseur est placé à l'intérieur d'un nœud XMLNode ou de l'un de ses nœuds descendants, à partir d'une zone en dehors du contexte du nœud. En d'autres termes, il est déclenché uniquement lorsque le contexte change.

Par exemple, lorsque vous déplacez le curseur situé en dehors de Customer dans CompanyName, l'événement ContextEnter pour Customer, Company et CompanyName est déclenché. Si vous déplacez ensuite le curseur de CompanyName vers CompanyRegion, seul l'événement ContextEnter pour CompanyRegion est déclenché car vous êtes encore dans le contexte de Company et Customer.

Les mêmes différences existent entre l'événement ContextLeave et l'événement Deselect.

Voir aussi

Tâches

Comment : ajouter des contrôles XMLNode à des documents Word

Comment : mapper des schémas à des documents Word dans Visual Studio

Procédure pas à pas : modification du volet Actions en fonction du contexte utilisateur

Concepts

Vue d'ensemble des éléments hôtes et des contrôles hôtes

XMLNodes, contrôle

Limitations de programmation des éléments hôtes et des contrôles hôtes

Autres ressources

Contrôles hôtes Word

Contrôles hôtes Excel