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)