initFocusEvent method

Initializes a new focus event that the IDocumentEvent::createEvent method created.

Syntax

HRESULT retVal = object.initFocusEvent(eventType, canBubble, cancelable, viewArg, detailArg, relatedTargetArg );

eventType [in]

Type: BSTR

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

blur

This event is an HTMLFrameSiteEvents::onblur event.

focus

This event is an HTMLFrameSiteEvents::onfocus event.

focusin

This event is an HTMLFrameSiteEvents::onfocusin event.

focusout

This event is an HTMLFrameSiteEvents::onfocusout 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.

viewArg [in]

An IHTMLWindow2 variable that specifies the active window, or NULL. This value is returned in the IDOMUIEvent::view property of the event.

detailArg [in]

Type: long

A long value that specifies additional information. This value is returned in the IDOMUIEvent::detail property of the event.

relatedTargetArg

The object used for the IDOMFocusEvent::relatedTarget attribute of the new focus event.

Type: HRESULT

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