pasteHTML Method

Pastes HTML text into the given text range, replacing any previous text and HTML elements in the range.

Syntax

TextRange.pasteHTML(sHTMLText)

Parameters

sHTMLText

Required. String that specifies the HTML text to paste. The string can contain text and any combination of the HTML tags described in HTML Elements.

Return Value

No return value.

Remarks

Although this method never fails, it might alter the HTML text to make it fit the given text range. For example, pasting a table cell into a text range that does not contain a table might cause the method to insert a TABLE element. For predictable results, paste only well-formed HTML text that fits within the given text range.

This method is accessible at run time. If elements are removed at run time, before the closing tag is parsed, areas of the document might not render.

This feature might not be available on non-Win32® platforms. For the latest information about Internet Explorer cross-platform compatibility, see article q172976  in the Microsoft Knowledge Base.

Example

This example uses the pasteHTML method to replace the current selection with a new paragraph.

<SCRIPT LANGUAGE="JScript">
var sel = document.selection;
if (sel!=null) {
    var rng = sel.createRange();
    if (rng!=null)
        rng.pasteHTML("<P><B>Selection has been replaced.</B></P>");
}
</SCRIPT>

Applies To

[ Object Name ] Platform Version Win16: Win32: Mac: Unix: WinCE: Version data is listed when the mouse hovers over a link, or the link has focus.	TextRange

Back to top

Did you find this topic useful? Suggestions for other topics? write us!

© 1999 microsoft corporation. all rights reserved. terms of use.