Document.SelectSingleNode method (Word)
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
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.