DocContextChangeEventObject Interface

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Objet d’événement utilisé lors d’un événement de modification de contexte Microsoft InfoPath.

public interface class DocContextChangeEventObject : Microsoft::Office::Interop::InfoPath::DocContextChangeEvent

[System.Runtime.InteropServices.Guid("096CD6D2-0786-11D1-95FA-0080C78EE3BB")]
public interface DocContextChangeEventObject : Microsoft.Office.Interop.InfoPath.DocContextChangeEvent

type DocContextChangeEventObject = interface
    interface DocContextChangeEvent

Public Interface DocContextChangeEventObject
Implements DocContextChangeEvent

Dérivé

Microsoft.Office.Interop.InfoPath.DocContextChangeEventObjectClass

Attributs

GuidAttribute

Implémente

DocContextChangeEvent

Exemples

Dans l’exemple suivant, un nœud nommé lastChanged est mis à jour en réponse aux modifications de contexte :

public void OnContextChange(<span class="label">DocContextChangeEvent</span> e)
{
 if ( e.Type == "ContextNode" &amp;&amp; !e.IsUndoRedo )
 {
  IXMLDOMNode contextNode = e.Context;
  IXMLDOMNode lastChangedNode = thisXDocument.DOM.selectSingleNode("/my:myRoot/my:lastChanged");
  lastChangedNode.text = contextNode.nodeName;
 }
}

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, y compris un lien vers les descriptions de ses membres, consultezDocContextChangeEvent .

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 passé 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 Type propriété retourne uniquement la valeur « ContextNode » pour les modifications de contexte dans Microsoft InfoPath 2003 Service Pack 1. 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é a la IsUndoRedo valeur true, le changement de contexte a été provoqué par une opération d’annulation ou de restauration au lieu d’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.

Propriétés

Context	Obtient une référence au nœud DOM (Document Object Model) XML qui est le nouveau nœud de contexte fourni par l’objet DocContextChangeEventObject . (Hérité de DocContextChangeEvent)
IsUndoRedo	Obtient une valeur indiquant si l'événement de modification de contexte s'est produit en réponse à l'annulation ou au rétablissement d'une opération. (Hérité de DocContextChangeEvent)
Type	Obtient le type d’événement de changement de contexte qui s’est produit lorsque l’événement OnContextChange a été déclenché. (Hérité de DocContextChangeEvent)
XDocument	Obtient une référence à l’objet XDocument associé à l’objet DocContextChangeEventObject dans un OnContextChange événement . (Hérité de DocContextChangeEvent)