IXMLDOMElement Interface
The IXMLDOMElement interface represents the element object. For more information, see the Microsoft XML SDK 3.0 documentation available at the Microsoft Web site.
In addition to the methods inherited from the IXMLDOMNodeIXMLDOMNode Interface, the IXMLDOMElement interface exposes the following methods.
Method |
Description |
|---|---|
get_tagName |
Retrieves the element name(that appears within the tag). |
getAttribute |
Retrieves the value of the named attribute. |
getAttributeNode |
Retrieves the named attribute node. |
getElementsByTagName |
Retrieves a list of all descendant elements that match the supplied name. |
removeAttribute |
Removes or replaces the named attribute. |
removeAttributeNode |
Removes the specified attribute from this element. |
setAttribute |
Specifies the value of the named attribute. |
setAttributeNode |
Adds or changes the supplied attribute node on this element. |
Remarks
Element nodes are among the most common objects in the XML document tree. Element nodes can have attributes associated with them. By definition, attributes are not defined as child nodes of the element and are not considered to be part of the document tree. Accordingly, the IXMLDOMElement object provides methods to make it easier to manage attributes, including methods to associate an attribute with an element, and to retrieve an attribute object and the attribute value by name.
To retrieve the set of all attributes associated with the element, you can also call the getAttribute method, which returns an IXMLDOMNamedNodeMap collection object that contains all the element's attributes.
Example
The following example retrieves a pointer to an IXMLDOMElement interface and assigns it as the new document element of an XML document.
#include “wmsserver.h”
#include <atlbase.h> // Includes CComVariant and CComBSTR.
// Declare variables.
IWMSServer* pServer;
IXMLDOMDocument* pPlaylist;
IXMLDOMElement* pXMLElement;
HRESULT hr;
CComVariant varFile;
VARIANT_BOOL bIsSuccessful;
CComBSTR bstrName;
// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer, NULL, CLSCTX_ALL,
IID_IWMSServer, (void**)&pServer);
if (FAILED(hr)) goto EXIT;
// Create the playlist object.
hr = pServer->CreatePlaylist(&pPlaylist);
// Load a sample playlist file.
varFile = "c:\\wmpub\\wmroot\\simple.wsx";
hr = pPlaylist->load(varFile, &bIsSuccessful);
if (FAILED(hr)) goto EXIT;
if (bIsSuccessful)
{
// Create a new element named "root."
bstrName = "root";
hr = pPlaylist->createElement(bstrName, &pXMLElement);
if (FAILED(hr)) goto EXIT;
// Assign pXMLElement as the new document element
// for the XML document.
hr = pPlaylist->putref_documentElement(pXMLElement);
if (FAILED(hr)) goto EXIT;
}
EXIT:
// TODO: Release temporary COM objects and uninitialize COM.