Share via


pasteHTML method

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

Syntax

HRESULT retVal = object.pasteHTML(html);

Parameters

  • html [in]
    Type: BSTR

    BSTR 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

Type: HRESULT

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

Standards information

There are no standards that apply here.

Remarks

This method 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-Microsoft Win32 platforms.

This method fails only when used inappropriately to paste HTML into a textarea element in Microsoft Internet Explorer 5 and later.