removeBehavior Method

Internet Development Index

Detaches a behavior from the element.

Syntax

bSuccess = object.removeBehavior(iID)

Parameters

iID Required. Integer that specifies the identifier returned from a previous addBehavior call.

Return Value

Returns one of the following possible values:

trueThe behavior was successfully removed.
falseThe behavior was not removed.

Remarks

This method applies only to attached behaviors, which are the original Dynamic HTML (DHTML) behaviors introduced in Microsoft® Internet Explorer 5. Element behaviors are a new feature in Internet Explorer 5.5 and cannot be added or removed from an element.

Example

This example uses the removeBehavior method to show how a behavior that implements a mouseover highlighting effect can be dynamically removed from all li elements on a page.

<SCRIPT LANGUAGE="JScript">
var collBehaviorID = new Array();
var collLI = new Array ();
var countLI = 0;
:
function detachBehavior()
{
for (i=0; i < countLI; i++)
collLI[i].removeBehavior (collBehaviorID [i]);
}
</SCRIPT>
:
Click <A HREF="javascript:detachBehavior()">here</A>
to remove highlighting effect.
:
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this method.

Applies To

A, ACRONYM, ADDRESS, APPLET, AREA, B, BASE, BASEFONT, BGSOUND, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, HEAD, hn, HR, HTML, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=hidden, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, ISINDEX, KBD, LABEL, LEGEND, LI, LINK, LISTING, MAP, MARQUEE, MENU, nextID, NOBR, NOFRAMES, NOSCRIPT, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, RT, RUBY, S, SAMP, SCRIPT, SELECT, SMALL, SPAN, STRIKE, STRONG, STYLE, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TITLE, TR, TT, U, UL, VAR, WBR, XML, XMP

See Also

addBehavior, Introduction to DHTML Behaviors, Using DHTML Behaviors, About Element Behaviors, Implementing DHTML Behaviors in Script