parentNode Property
A version of this page is also available for
4/8/2010
Contains the parent node.
Script Syntax
var objXMLDOMNode = oXMLDOMNode.parentNode;
Remarks
Script Parameters
None.
Script Return Value
Object. All nodes except Document, DocumentFragment, and Attribute nodes can have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is Null.
C/C++ Syntax
HRESULT get_parentNode(
IXMLDOMNode** parent
);
Remarks
C/C++ Parameters
- parent
[out, retval] Parent of the given node instance. All nodes except Document, DocumentFragment, and Attribute nodes can have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is Null.
C/C++ Return Values
- S_FALSE
Value returned if there is no parent.
- S_OK
Value returned if successful.
- E_INVALIDARG
Value returned if parent is Null.
Requirements
| Header | msxml2.h, msxml2.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
General Remarks
This value depends on the value of the nodeType property.
| Value | Description |
|---|---|
NODE_ATTRIBUTE, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT |
Returns Null; these nodes do not have parents. |
NODE_CDATA_SECTION |
Returns the element or entity reference containing the CDATA section. |
NODE_COMMENT |
Returns the element, entity reference, document type, or document containing the comment. |
NODE_DOCUMENT_TYPE |
Returns the document node. |
NODE_ELEMENT |
Returns the parent node of the element. If the element is the root node in the tree, the parent is the document node. If the node is the document node, parentNode is Null. |
NODE_ENTITY |
Returns the document type node. |
NODE_ENTITY_REFERENCE |
Returns the element, attribute, or entity reference containing the entity reference. |
NODE_NOTATION |
Returns the document type node. |
NODE_PROCESSING_INSTRUCTION |
Returns the document, element, document type, or entity reference containing the processing instruction. |
NODE_TEXT |
Returns the parent element, attribute, or entity reference. |
This property is read-only, and applies to the following objects and interfaces:
IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, and IXTLRuntime