XMLNode, contrôle

Article
08/10/2011

Important Les informations contenues dans cette rubrique concernant Microsoft Word sont fournies exclusivement pour le bénéfice et l'utilisation des individus et des organisations se trouvant en dehors des États-Unis et de ses territoires et qui utilisent, ou développent des programmes exécutés avec, des produits Microsoft Word dont la licence Microsoft est antérieure à janvier 2010, date à laquelle Microsoft a supprimé de Microsoft Word l'implémentation d'une fonctionnalité spécifique liée au code XML personnalisé. 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 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

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. Une fois que Visual Studio a créé le nœud XML, vous pouvez effectuer des programmations directement sur cette plage 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.