Compartilhar via


Método Document.SelectSingleNode (Word)

Retorna um objeto XMLNode que representa o primeiro nó que coincide com o parâmetro XPath no documento especificado.

Sintaxe

expression. SelectSingleNode( _XPath_ , _PrefixMapping_ , _FastSearchSkippingTextNodes_ )

expressão Obrigatório. Uma variável que representa um objeto Document.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
XPath Obrigatório String Uma sequência de caminho XPath válida. Para obter mais informações sobre o XPath, consulte a documentação de referência do XPath no Web site Microsoft Developer Network (MSDN).
PrefixMapping Opcional Variant Fornece o prefixo no esquema no qual será realizada a busca. Use o parâmetro PrefixMapping se o seu parâmetro XPath usar nomes para busca de elementos.
Fastsearchskippingtextnodes Opcional Boolean True ignora todos os nós de texto ao procurar o nó especificado. False inclui nós de texto na pesquisa. Valor padrão é True.

Valor de retorno

XMLNode

Comentários

O parâmetro como FastSearchSkippingTextNodes a definição como False reduz o desempenho, pois o Microsoft Word procura por todos os nós em um documento em comparação com o texto contido no nó.

Exemplo

O exemplo a seguir retorna o primeiro elemento título identificado no documento ativo o qual é um elemento filho no elemento livro.

Dim objElement As XMLNode 
Dim strElement As String 
Dim strPrefix As String 
 
strElement = "/x:catalog/x:book/x:title" 
strPrefix = "xmlns:x=""" & ActiveDocument _ 
 .XMLSchemaReferences(1).NamespaceURI & """" 
 
Set objElement = ActiveDocument _ 
 .SelectSingleNode(strElement, strPrefix)

Confira também

Objeto Document

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.