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.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
<GuidAttribute("096cd6d2-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DocContextChangeEventObject _
    Inherits DocContextChangeEvent, DocEvent
'Utilisation
Dim instance As DocContextChangeEventObject

[GuidAttribute("096cd6d2-0786-11d1-95fa-0080c78ee3bb")]
public interface DocContextChangeEventObject : DocContextChangeEvent, 
    DocEvent

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 » des changements de contexte dans Microsoft InfoPath. Néanmoins, si le code d'un gestionnaire d'événements effectue des actions qui dépendent de la fonctionnalité active, ce code doit toujours être conçu de manière à vérifier la valeur de la propriété Type, car les versions ultérieures d'InfoPath risquent d'utiliser des valeurs différentes pour d'autres modifications de contexte.

Lorsque la propriété IsUndoRedo a la valeur true, cela signifie que la modification du contexte est due à une opération d'annulation ou de rétablissement d'une action plutôt qu'à une modification explicite du contexte utilisateur. Il est conseillé d'éviter d'effectuer des opérations qui modifient XML DOM dans le cadre de l'événement OnContextChange, en réponse aux opérations d'annulation ou de rétablissement d'action, car elles risquent d'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 :

[InfoPathEventHandler(EventType=InfoPathEventType.OnContextChange)]
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;
 }
}

Voir aussi

Référence

DocContextChangeEventObject - Membres

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms