DocContextChangeEventObject - Interface
Un événement d'objet utilisé pendant un événement de changement de contexte Microsoft InfoPath.
Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)
Syntaxe
'Déclaration
<GuidAttribute("096CD6D2-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface DocContextChangeEventObject _
Inherits DocContextChangeEvent
'Utilisation
Dim instance As DocContextChangeEventObject
[GuidAttribute("096CD6D2-0786-11D1-95FA-0080C78EE3BB")]
public interface DocContextChangeEventObject : DocContextChangeEvent
Remarques
Ce type est le wrapper d’une coclasse requise par le code managé pour l’interopérabilité COM. Utilisez ce type pour accéder aux membres de l’interface COM implémentée par cette coclasse. Pour plus d’informations sur l’interface COM et pour accéder à un lien vers les descriptions de ses membres, voirDocContextChangeEvent.
L'objet DocContextChangeEvent fournit un certain nombre de propriétés qui peuvent être utilisées lors d'une modification de contexte pour interagir par programme avec les données du document XML sous-jacent d'un formulaire, afin d'offrir un commentaire contextuel à l'utilisateur ou d'effectuer des actions pour lui.
L'objet DocContextChangeEvent est transmis en tant que paramètre à l'événement OnContextChange .
L'objet DocContextChangeEvent permet de récupérer les informations du nœud XML DOM (Document Object Model) qui représente le contexte actuel du document XML sous-jacent du formulaire. En outre, il indique la nature de la modification du contexte et si cette modification s'est produite en réponse à une opération d'annulation ou de rétablissement d'une action effectuée par l'utilisateur.
La propriété Type renvoie uniquement la valeur « ContextNode » pour les modifications de contexte dans Microsoft InfoPath 2003 Service Pack 1. Néanmoins, si le code dans un gestionnaire d'événements effectue des actions qui dépendent de fonctionnalités actuelles, que ce code doit toujours être conçu de manière pour vérifier la valeur de la propriété Type, car les versions ultérieures d'InfoPath peuvent utiliser des valeurs différentes pour d'autres modifications de contexte.
Lorsque la propriété IsUndoRedo est true, la modification de contexte a été provoquée par une opération d'annulation ou de rétablissement plutôt que par une modification de contexte utilisateur explicite. Opérations qui modifient le modèle DOM XML dans un événement OnContextChange doivent être évitées en réponse à annuler ou rétablir des actions, car ils peuvent interférer avec l'intention de l'utilisateur de restaurer des données à un état antérieur.
Exemples
Dans l'exemple suivant, un nœud nommé lastChanged est mis à jour en réponse à des modifications de contexte :
public void OnContextChange(DocContextChangeEvent e)
{
if ( e.Type == "ContextNode" && !e.IsUndoRedo )
{
IXMLDOMNode contextNode = e.Context;
IXMLDOMNode lastChangedNode = thisXDocument.DOM.selectSingleNode("/my:myRoot/my:lastChanged");
lastChangedNode.text = contextNode.nodeName;
}
}