createEventObject Method

MS Office DHTML, HTML & CSS

previous page next page

Click to return to the Component Development home page

element Object

oncontentready Event

HTC Reference

Web Workshop | Component Development

createEventObject Method

Creates an event object that can be used when passing event context information to the EVENT element's fire method.

Syntax

oEvent = createEventObject()

Return Value

Returns an event object.

Remarks

The same event object cannot be reused in multiple calls to the fire method.

Note All properties of the event object created using createEventObject are read/write, including those that would be read-only in Dynamic HTML. This allows you to set properties on the event object from the HTML Component (HTC), before firing the event.

Example

This example is derived from a calculator behavior sample. When the result changes, the behavior fires a custom onResultChange event back to the page, passing the result as a custom property of the event object.

Sample Code
<PUBLIC:EVENT NAME="onResultChange" ID="rcID"  />

<SCRIPT LANGUAGE="JScript">

:
function doCalc()
{
   :
   oEvent = createEventObject();
   oEvent.result = sResult;
   rcID.fire (oEvent);
}
</SCRIPT >
This example shows what the containing page looks like.
<HTML XMLNS:InetSDK>
<HEAD>
<STYLE>
@media all {
   InetSDK\:CALC    {behavior:url(engine.htc)} 
}   
</STYLE>
</HEAD>

<InetSDK:CALC id="myCalc"
    onResultChange="resultWindow.innerText=window.event.result">
<TABLE>
<TR><DIV ID="resultWindow" STYLE="border:'.025cm solid gray'"
         ALIGN=RIGHT>0.</DIV></TR>
<TR><TD><INPUT TYPE=BUTTON VALUE=" 7 "></TD>
    <TD><INPUT TYPE=BUTTON VALUE=" 8 "></TD>
    <TD><INPUT TYPE=BUTTON VALUE=" 9 "></TD>
    <TD><INPUT TYPE=BUTTON VALUE=" / "></TD>
    <TD><INPUT TYPE=BUTTON VALUE=" C "></TD>
</TR>
    :   
</TABLE>
</InetSDK:CALC>
</HTML>
This feature requires Internet Explorer 5 or later. Click the icon below to install the latest version. Then reload this page to view the sample.