View.SelectNodes - Méthode
Sélectionne une plage de nœuds dans une vue basée sur le nœud DOM (Document Object Model) XML de début spécifié, le nœud DOM XML de fin et le contexte de vue.
Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)
Syntaxe
'Déclaration
Sub SelectNodes ( _
pxnStartNode As IXMLDOMNode, _
varEndNode As Object, _
varViewContext As Object _
)
'Utilisation
Dim instance As View
Dim pxnStartNode As IXMLDOMNode
Dim varEndNode As Object
Dim varViewContext As Object
instance.SelectNodes(pxnStartNode, varEndNode, _
varViewContext)
void SelectNodes(
IXMLDOMNode pxnStartNode,
Object varEndNode,
Object varViewContext
)
Paramètres
pxnStartNode
Type : Microsoft.Office.Interop.InfoPath.Xml.IXMLDOMNodeNœud DOM XML qui commence la plage.
varEndNode
Type : System.ObjectNœud DOM XML qui termine la plage. S'il n'est pas spécifié, seul le nœud DOM XML de début est utilisé.
varViewContext
Type : System.ObjectIdentificateur (ID) du contrôle utilisé pour le contexte, qui est un élément dont le contexte de vue spécifié est xd:CtrlId.
Remarques
Si un contexte de vue est spécifié, tous les nœuds DOM XML à sélectionner doivent se trouver dans ce contexte.
Si des arguments de la méthode SelectNodes ont la valeur Null ou ne sont pas exposés dans la vue, la méthode SelectNodes renvoie une erreur. En outre, si plusieurs jeux d'éléments de vue sont mappés aux mêmes nœuds DOM XML spécifiés, dans le même contexte de vue spécifié, la méthode SelectNodes renvoie également une erreur.
Notes
La méthode SelectNodes exige que les nœuds puissent, du point de vue de la structure, être sélectionnés dans la vue.
Exemples
Dans l'exemple suivant, la méthode SelectNodes de l'objet ViewObject est utilisée pour définir une sélection sur un seul élément dans la vue, correspondant au nœud DOM XML spécifié. À l'aide de la méthode GetSelectedNodes de l'objet View , le code détermine ensuite si la sélection a réussi en affichant des informations sur le nœud DOM XML dans une boîte de message. Cet exemple nécessite un tableau extensible nommé group1. La première occurrence est sélectionnée :
XMLNodesCollection selectedNodes;
IXMLDOMNode group1;
group1 = thisXDocument.DOM.selectSingleNode(@"//my:group1");
thisXDocument.View.SelectNodes(group1, Type.Missing, Type.Missing);
selectedNodes = thisXDocument.View.GetSelectedNodes();
if (selectedNodes.Count > 0)
{
thisXDocument.UI.Alert(selectedNodes[0].nodeName + "\n\n" + selectedNodes[0].text);
}