View.GetContextNodes(Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Obtém uma referência a uma XMLNodesCollection coleção que é preenchida com nós DOM (Modelo de Objeto de Documento XML) com base no contexto atual.

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

Parâmetros

varNode

Object

Um nó XML DOM.

varViewContext

Object

A ID do controle que é usado para o contexto.

Retornos

XMLNodesCollection

Uma referência à coleção XMLNodesCollection .

Exemplos

No exemplo a seguir, o método GetContextNodes do ViewObject objeto é usado para retornar uma coleção de nós XML DOM com base no contexto atual. Em seguida, o código passa pela coleção de nós XML DOM que procuram um nó específico. Quando ele é encontrado, o texto de field1 é atualizado. Este exemplo requer uma estrutura de uma seção repetida chamada group1 contendo um campo chamado 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;
  }
 }

Comentários

A coleção retornada pelo método GetContextNodes consiste na sequência de nós XML DOM mapeados do modo de exibição, correspondentes ao nó XSLT (Transformação XSL) atual, começando na seleção atual e subindo pelos ancestrais de exibição até a marca BODY.

Se nenhum parâmetro for usado, os nós de contexto serão baseados na seleção atual. Se os parâmetros forem usados, os nós de contexto retornados serão aqueles que seriam retornados com base na seleção que seria obtida da chamada do SelectNodes(IXMLDOMNode, Object, Object) método.

Observação: o método GetContextNodes não retornará nós com base na seleção atual se usado no OnClick caso de um botão no modo de exibição, uma vez que o foco é perdido do controle que se destina a estar no contexto. Para evitar esse comportamento, use o método GetContextNodes de um painel de tarefas personalizado, menu ou barra de ferramentas.