Edit

Document.SelectSingleNode method (Word)

  • Article

Returns an XMLNode object that represents the first node that matches the XPath parameter in the specified document.

Syntax

expression. SelectSingleNode( _XPath_ , _PrefixMapping_ , _FastSearchSkippingTextNodes_ )

expression Required. A variable that represents a Document object.

Parameters

Name Required/Optional Data type Description
XPath Required String A valid XPath string. For more information on XPath, see the XPath reference documentation on the Microsoft Developer Network (MSDN) Web site.
PrefixMapping Optional Variant Provides the prefix in the schema against which to perform the search. Use the PrefixMapping parameter if your XPath parameter uses names to search for elements.
FastSearchSkippingTextNodes Optional Boolean True skips all text nodes while searching for the specified node. False includes text nodes in the search. Default value is True.

Return value

XMLNode

Remarks

Setting the FastSearchSkippingTextNodes parameter to False diminishes performance because Microsoft Word searches all nodes in a document against the text contained in the node.

Example

The following example returns the first title element found in the active document that is a child element of the book element.

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)

See also

Document Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.