Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
initMessageEvent
Collapse the table of content
Expand the table of content

initMessageEvent method

Initializes a new cross-document message (XDM) event that the IDocumentEvent::createEvent method created.

HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 6.1Internet Explorer 9

 

Syntax


HRESULT retVal = object.initMessageEvent(eventType, canBubble, cancelable, data, origin, lastEventId, source);

Parameters

eventType [in]

Type: BSTR

One of the following values, or a user-defined custom event type:

message

An HTMLWindowEvents3::onmessage event.

canBubble [in]

Type: VARIANT_BOOL

VARIANT_TRUE (true)

The event should propagate upward.

VARIANT_FALSE (false)

The event does not propagate upward.

cancelable [in]

Type: VARIANT_BOOL

VARIANT_TRUE (true)

The default action can be canceled.

VARIANT_FALSE (false)

The default action cannot be canceled.

data [in]

Type: BSTR

The cross-document message. This value is returned as the IDOMMessageEvent::data attribute of the event.

origin [in]

Type: BSTR

The originating domain of the message. This value is returned as the IDOMMessageEvent::origin attribute of the event.

lastEventId [in]

Type: BSTR

Not used. Set this parameter to an empty string.

source [in]

Type: IHTMLWindow2

A reference to the window that generated the event. This value is returned as the IDOMMessageEvent::source attribute of the event.

Return value

Type: HRESULT

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

Standards information

Remarks

The lastEventId parameter emulates server-initiated messages, which Windows Internet Explorer 9 does not support.

 

 

Community Additions

ADD
Show:
© 2015 Microsoft