_XDocumentEventSink2_Event.OnContextChange Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit après une modification du nœud de contexte.
public:
event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnContextChangeEventHandler ^ OnContextChange;event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnContextChangeEventHandler OnContextChange;member this.OnContextChange : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnContextChangeEventHandler Event OnContextChange As _XDocumentEventSink2_OnContextChangeEventHandler Type d'événement
Exemples
public void OnContextChange(DocContextChangeEvent e)
{
if (e.Type == "ContextNode")
{
IXMLNode expNode=XDocument.DOM.selectSingleNode("//my:field4");
// set field4 with the name of the current context.
expNode.text=e.Context.nodeName;
}
}
public void OnContextChange(DocContextChangeEvent e)
{
if (e.Type == "ContextNode")
{
IXMLNode expNode=XDocument.DOM.selectSingleNode("//my:field4");
// set field4 with the name of the current context.
expNode.text=e.Context.nodeName;
}
}
Remarques
Le nœud de contexte est le nœud XML DOM mappé sur la vue qui correspond au conteneur (ou à l’élément) associé à la sélection XML actuelle. Par exemple, si la sélection actuelle de la vue se trouve dans une zone de texte, le nœud de contexte représente le nœud auquel la zone de texte est liée. Si la sélection actuelle est une section extensible, le nœud de contexte représente le nœud lié à cet élément. Si deux sections extensibles sont sélectionnées, le nœud de contexte est le nœud XML DOM ancêtre des deux éléments mappés sur la vue.
L’événement OnContextChange est asynchrone. Il ne se déclenche pas à chaque modification dans le nœud de contexte ; au lieu de cela, il se déclenche une fois que l’application a arrêté de traiter d’autres événements.
Lorsque le document se charge ou lorsqu’un changement d’affichage se produit, l’événement OnContextChange se produit après les OnLoadévénements et OnSwitchView .
Lorsque la IsUndoRedo propriété de l’objet a la DocContextChangeEventObject valeur true, le changement de contexte a été provoqué par une opération d’annulation ou de rétablissement d’un utilisateur plutôt que par une modification explicite du contexte utilisateur. Il est conseillé d’éviter d’effectuer des opérations qui modifient le DOM XML dans le cadre de l’événement OnContextChange en réponse à des opérations d’annulation ou de rétablissement, car elles risquent d’interférer avec l’intention de l’utilisateur de restaurer des données à un état antérieur.
Pour les contrôles de zone de texte enrichi, l’événement OnContextChange n’est pas déclenché en réponse à des modifications de contexte dans le contenu XHTML, en d’autres termes, en réponse à des modifications de sélection du texte enrichi dans le contrôle. La GetContextNodes(Object, Object) méthode peut être utilisée pour déterminer la sélection dans les contrôles de zone de texte enrichi.