PUBLIC:EVENT Element | Internet Development Index |
Defines an event of the HTML Component (HTC) to be exposed to the containing document.
Syntax
<PUBLIC:EVENT ID = "sEventID" NAME = "sName" />
Attributes
- ID
- Optional. String that uniquely identifies the PUBLIC:EVENT element within the component. This attribute is analogous to the ID attribute in Dynamic HTML (DHTML).
- NAME
- Required. String that specifies the name of the event exposed to the containing document.
Methods
- eventID.fire( [oEvent] )
- Fires the event to the containing document.This method has the following parameter:
oEvent Object that specifies the event object containing context information.
Element Information
Parent elements PUBLIC:COMPONENT Child elements None Minimum availability Internet Explorer 5 Minimum operating systems Windows 95, Windows NT 4.0
Remarks
By specifying a NAME attribute similar to a standard event already defined for the element, a behavior can override the element's default behavior.
Events defined for a behavior do not bubble; they only fire on the element to which the behavior is attached.
Examples
This example is derived from a calculator behavior sample. Whenever the result changes, the HTC fires a custom onResultChange event back to the page, passing the result as a custom property of the event object.
<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> <TR><TD><INPUT TYPE=BUTTON VALUE=" 4 "></TD> <TD><INPUT TYPE=BUTTON VALUE=" 5 "></TD> <TD><INPUT TYPE=BUTTON VALUE=" 6 "></TD> <TD><INPUT TYPE=BUTTON VALUE=" * "></TD> <TD><INPUT TYPE=BUTTON VALUE=" % " DISABLED></TD> </TR> <TR><TD><INPUT TYPE=BUTTON VALUE=" 1 "></TD> <TD><INPUT TYPE=BUTTON VALUE=" 2 "></TD> <TD><INPUT TYPE=BUTTON VALUE=" 3 "></TD> <TD><INPUT TYPE=BUTTON VALUE=" - "></TD> <TD><INPUT TYPE=BUTTON VALUE="1/x" DISABLED></TD> </TR> <TR><TD><INPUT TYPE=BUTTON VALUE=" 0 "></TD> <TD><INPUT TYPE=BUTTON VALUE="+/-"></TD> <TD><INPUT TYPE=BUTTON VALUE=" . "></TD> <TD><INPUT TYPE=BUTTON VALUE=" + "></TD> <TD><INPUT TYPE=BUTTON VALUE=" = "></TD> </TR> </TABLE> </InetSDK:CALC> </HTML>
See Also
Introduction to DHTML Behaviors, Using HTML Components to Implement DHTML Behaviors in Script, PUBLIC:METHOD, PUBLIC:PROPERTY