normalize method

Merges adjacent Document Object Model (DOM) objects to produce a normalized document object model.


HRESULT retVal = object.normalize();


This method has no parameters.

Return value


If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Standards information


By calling object.IHTMLDocument7::normalize before the subelements of an object are manipulated, you ensure that the document object model has a consistent structure. The normal form is useful for operations that require a consistent document tree structure, and it ensures that the document object model view is identical when it is saved and reloaded.

Note The IHTMLDocument7::normalize method does not merge adjacent CDATA sections, allowing for an inconsistent object model when CDATA sections are present.

The IHTMLDocument7::normalize method was introduced in Microsoft Internet Explorer 6.