DhDocument.recreateElements

Overview | Methods | This Package | All Packages

DhDocument.recreateElements

Deserializes HTML text generated by getHTML.

Syntax

public DhElement[] recreateElements( String html )

public DhElement[] recreateElements( String html, boolean fHonorIDs )

Parameters

html

The text that was generated by calling getHTML on a specified DhElement.

fHonorIDs

Set to true to prevent destruction of ID attributes.

Return Value

Returns the corresponding tree of derivations of DhElement that originally created the text in the html parameter.

Remarks

The default case of calling this method ignores the ID attributes of the HTML and overrides those attributes with identifiers that are unique to this document. To control this behavior, use recreateElements(String, boolean).

Passing true to fHonorIDs instructs this method not to overwrite the ID attributes of the HTML tags in the html parameter. This is a very advanced usage of this method. If ID attributes conflict with elements already on the page, the resulting behavior is undefined in the rest of the package.