Document.SelectNodes Method (Word)
Returns an XMLNodes collection that represents all the nodes that match the XPath parameter in the order in which they appear in the document or range.
Syntax
expression .SelectNodes(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 False. |
Return Value
XMLNodes
Remarks
Setting the FastSearchSkippingTextNodes parameter to True diminishes performance, because Microsoft Word searches all nodes in a document against the text contained in the node.
Example
The following example returns a collection of all book elements in the active document.
Dim objElements As XMLNodes
Dim strElement As String
Dim strPrefix As String
strElement = "/x:catalog/x:book"
strPrefix = "xmlns:x=""" & ActiveDocument _
.XMLSchemaReferences(1).NamespaceURI & """"
Set objElements = ActiveDocument _
.SelectNodes(strElement, strPrefix)