Sets a user's home page to the specified value.
Syntax
homePage.setHomePage(sPageURL)
Parameters
| sPageURL |
Required.
A String that specifies the path or file name of the user's home page. |
Return Value
No return value.
Remarks
The setHomePage method prompts the user to confirm the new home page value before setting the value on the browser.
This method requires a user-initiated action, such as clicking on a link, or tabbing to a link and pressing enter. The Pop-up Blocker feature in Microsoft Internet Explorer 6 prevents this method from executing automatically.
Example
This example uses the setHomePage method to set a user's home page.
<HTML XMLNS:IE>
<HEAD>
<STYLE>
@media all {
IE\:HOMEPAGE {behavior:url(#default#homepage)}
}
</STYLE>
<SCRIPT>
function fnSet(){
oHomePage.setHomePage(oHomeHref.value);
event.returnValue = false;
}
</SCRIPT>
</HEAD>
<BODY>
<IE:HOMEPAGE ID="oHomePage" />
<INPUT TYPE=text ID=oHomeHref VALUE="http://www.microsoft.com">
<INPUT TYPE=button VALUE="Set" onclick="fnSet()">
</BODY>
</HTML>
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.
.gif)
Standards Information
There is no public standard that applies to this method.
Applies To
See Also