Export (0) Print
Expand All
2 out of 4 rated this helpful - Rate this topic

write method

Writes one or more HTML expressions to a document in the specified window.

Document Object Model (DOM) Level 2 HTML Specification, Section 1.5

Syntax


HRESULT retVal = object.write(psarray);

Parameters

psarray [in]

Type: SAFEARRAY

A SAFEARRAY of BSTR that specifies the text and HTML tags to write.

Return value

Type: HRESULT

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

Standards information

Remarks

Note  When document.IHTMLDocument2::write or document.IHTMLDocument2::writeln is used in an event handler, you must also use document.IHTMLDocument2::close.

Examples

This example shows how to write a string to the document.


    IHTMLDocument2 *document; // Declared earlier in the code
    BSTR bstr = SysAllocString(OLESTR("Written by IHTMLDocument2::write()."));
    // Creates a new one-dimensional array
    SAFEARRAY *psaStrings = SafeArrayCreateVector(VT_VARIANT, 0, 1);
    if (psaStrings == NULL) {
        goto cleanup;
    }
    VARIANT *param;
    HRESULT hr = SafeArrayAccessData(psaStrings, (LPVOID*)&param);
    param->vt = VT_BSTR;
    param->bstrVal = bstr;
    hr = SafeArrayUnaccessData(psaStrings);
    hr = document->write(psaStrings);
cleanup:
    // SafeArrayDestroy calls SysFreeString for each BSTR
    if (psaStrings != NULL) {
        SafeArrayDestroy(psaStrings);
    }

See also

Reference
IHTMLDocument2::writeln
IHTMLDocument2::open

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.