View.GetContextNodes - Méthode

Article
05/11/2015

Obtient une référence à une collection XMLNodesCollection qui est remplie de nœuds DOM (Document Object Model ) XML reposant sur le contexte actuel.

Espace de noms : Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly : Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
Function GetContextNodes ( _
    varNode As Object, _
    varViewContext As Object _
) As XMLNodesCollection
'Utilisation
Dim instance As View
Dim varNode As Object
Dim varViewContext As Object
Dim returnValue As XMLNodesCollection

returnValue = instance.GetContextNodes(varNode, _
    varViewContext)

XMLNodesCollection GetContextNodes(
    Object varNode,
    Object varViewContext
)

Paramètres

varNode
Type : System.Object

Nœud DOM XML.

varViewContext
Type : System.Object

Identificateur (ID) du contrôle utilisé pour le contexte.

Valeur renvoyée

Type : Microsoft.Office.Interop.InfoPath.SemiTrust.XMLNodesCollection
Référence à la collection XMLNodesCollection.

Remarques

La collection renvoyée par la méthode GetContextNodes se compose d'une série de nœuds DOM XML, mappés à partir de la vue, correspondant au nœud transformation XSL (XSLT) actuel, commençant à la sélection actuelle et remontant dans les ancêtres de vue jusqu'à la balise BODY.

Si aucun paramètre n'est utilisé, les nœuds de contexte sont basés sur la sélection actuelle. Si des paramètres sont utilisés, les nœuds de contexte renvoyés sont ceux qui seraient renvoyés sur la base de la sélection obtenue en appelant la méthode SelectNodes.

Notes

La méthode GetContextNodes ne renvoie pas de nœuds basés sur la sélection actuelle si elle est utilisée dans l'événement OnClick d'un bouton de la vue, car l'accent n'est plus sur le contrôle prévu dans ce contexte. Pour éviter ce comportement, utilisez la méthode GetContextNodes à partir d'un volet Office personnalisé, d'un menu ou d'une barre d'outils.

Important

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Exemples

Dans l'exemple suivant, la méthode GetContextNodes de l'objet ViewObject est utilisée pour renvoyer une collection de nœuds DOM XML basés sur le contexte actuel. Le code effectue ensuite une boucle sur la collection de nœuds DOM XML, à la recherche d'un nœud particulier. Une fois ce nœud trouvé, le texte du field1 est mis à jour. Cet exemple requiert une structure d'une section extensible nommée group1 contenant un champ nommé field1.

XMLNodesCollection contextNodes = thisXDocument.View.GetContextNodes(Type.Missing, Type.Missing);
// Scan the list of context nodes for an field1 node and if one is found
// update its text.
 foreach (IXMLDOMNode contextNode in contextNodes)
 {
  if (contextNode.nodeName == "my:group1")
  {
   contextNode.selectSingleNode("my:field1").text = "found node";
   break;
  }
 }

Voir aussi

Référence

View interface

View - Membres

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

Partager via