Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft