View.GetContextNodes(Object, Object) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Obtient une référence à une XMLNodesCollection collection qui est remplie avec des nœuds DOM (Document Object Model) XML en fonction du contexte actuel.

public Microsoft.Office.Interop.InfoPath.XMLNodesCollection GetContextNodes (object varNode, object varViewContext);

abstract member GetContextNodes : obj * obj -> Microsoft.Office.Interop.InfoPath.XMLNodesCollection

Public Function GetContextNodes (Optional varNode As Object, Optional varViewContext As Object) As XMLNodesCollection

Paramètres

varNode

Object

Nœud DOM XML.

varViewContext

Object

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

Retours

XMLNodesCollection

Référence à la collection XMLNodesCollection.

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 en fonction du contexte actuel. Le code effectue ensuite une boucle sur la collection de nœuds DOM XML, à la recherche d'un nœud particulier. Lorsqu’il est trouvé, le texte de field1 est mis à jour. Cet exemple nécessite une structure d’une section répétée nommée group1 contenant un champ nommé field1.

XMLNodesCollection contextNodes = thisXDocument.View.<span class="label">GetContextNodes</span>(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;
  }
 }

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 retournés sont ceux qui seraient retournés en fonction de la sélection obtenue à partir de l’appel de la SelectNodes(IXMLDOMNode, Object, Object) méthode .

Remarque : la méthode GetContextNodes ne retourne pas de nœuds en fonction de la sélection actuelle si elle est utilisée en OnClick cas de bouton dans la vue, car le focus est perdu du contrôle destiné à être dans le 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.