homePage Behavior

This topic documents a feature of Binary Behaviors, which are obsolete as of Internet Explorer 10.

Contains information about a user's homepage.

Syntax

XML
  	<Prefix:

CustomTag ID=sID STYLE="behavior:url('#default#homePage')" />

HTML <ELEMENT STYLE="behavior:url('#default#homePage')" ID=sID>
Scripting object.style.behavior = "url('#default#homePage')"
object.addBehavior ("#default#homePage")

Possible Values

Prefix Prefix that associates the CustomTag with an XML namespace. This prefix is set using the XMLNS attribute of the HTML tag.
CustomTag User-defined tag.
sID String that specifies a unique identifier for the object.

Members Table

The following table lists the members exposed by the homePage object.

Method Description
isHomePage

Deprecated. Determines whether the specified URL refers to the client's home page.

navigateHomePage

Navigates the browser to a user's home page.

setHomePage

Deprecated. Sets a user's home page to the specified value.

Remarks

The members listed in the preceding table might not be accessible through scripting until the window. onload event fires. Waiting for this event to fire ensures that the page is completely loaded, that all behaviors have been applied to corresponding elements on the page, and that all the behavior's properties, methods, and events are available for scripting. To prevent a scripting error—which would indicate that the object does not support a particular member—do not use any of the behavior-defined members before the window. onload event fires.

The homePage behavior is available as of Microsoft Internet Explorer 5, in the Microsoft Win32 and Unix platforms.

Example

This example uses the homePage behavior to set the user's home page to the specified URL.

<HTML XMLNS:IE>
<HEAD>
<STYLE>
@media all {
   IE\:homePage {behavior:url(#default#homepage)}
}   
</STYLE>

<SCRIPT>
function fnVerify(){
    sQueryHome = oHomePage.isHomePage(oHomeHref.value);
    alert(sQueryHome);
    event.returnValue = false;
}
function fnGo(){
    oHomePage.navigateHomePage();
    event.returnValue=false;
}
function fnSet(){
    oHomePage.setHomePage(oHomeHref.value);
    event.returnValue = false;
}
</SCRIPT>
</HEAD>
<BODY>
<IE:homePage ID="oHomePage" />
<INPUT TYPE=text ID=oHomeHref VALUE="https://www.microsoft.com">
<INPUT TYPE=button VALUE="Verify" onclick="fnVerify()">
<INPUT TYPE=button VALUE="Set" onclick="fnSet()">
<INPUT TYPE=button VALUE="Navigate" onclick="fnGo()">
</BODY>
</HTML>

Code example: https://samples.msdn.microsoft.com/workshop/samples/author/behaviors/homepage1.htm

Applies To

A, ABBR, ACRONYM, ADDRESS, APPLET, AREA, B, BASE, BASEFONT, BDO, BGSOUND, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, 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, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TITLE, TR, TT, U, UL, VAR, WBR, XML, XMP

See Also

Introduction to DHTML Behaviors