In order to access this site you need to enable JavaScript!

You are here: Reference > JavaScript > client-side > browser > objects > external

external object

Browser support:

Provides access to some additional functionalities in Internet Explorer.

The external object is commonly used to add new elements to the Favorites (AddFavorite method) or to display a system dialog (ShowBrowserUI method).

Syntax:

Properties that reference the object:

•	window.external

Possible members:

Properties:

frozen

Returns a Boolean value that indicates whether the document containing the current Scriptlet Component is ready to handle events.

menuArguments

Retrieves a reference to the window object that contains the context menu.

Methods:

AddChannel


7

Displays a dialog box where the user has the ability to add a new channel URL, or modify the previously specified one.

AddDesktopComponent

Adds an item (image or website with location) to the Microsoft Active Desktop.

AddFavorite

Displays the 'Add a Favorite' dialog box for the specified URL and title in Internet Explorer.

AddSearchProvider

7

Installs a search engine plugin into the browser application.

AutoCompleteSaveForm

Stores the values and names of the named input:password and input:text elements in the specified form for autocompletion.

AutoScan


7

Attempts to find a Web site based on the specified domain part.

bubbleEvent

Dispatches the current standard event from a Scriptlet Component to the browser window.

IsSearchProviderInstalled

7

Returns an integer that represents whether the specified search provider is installed and whether it is the default.

IsSubscribed

Returns whether the client is subscribed to the specified channel.

NavigateAndFind

Loads the document at the specified URL into the current window and selects the specified text.

raiseEvent

Dispatches the specified custom event from a Scriptlet Component to the browser window.

ShowBrowserUI

Opens the specified system dialog.

Example HTML code 1:

This example shows how to add a page to the Favorites (Bookmarks) in Internet Explorer and Firefox.

<head>
    <script type="text/javascript">
        function AddToFavorites () {
            if (window.sidebar) {        // Firefox
                window.sidebar.addPanel ('Dottoro help page', 'http://help.dottoro.com', '');
            } 
            else {
                if (window.external && ('AddFavorite' in window.external)) {
                        // Internet Explorer
                    window.external.AddFavorite ('http://help.dottoro.com', 'Dottoro help page');
                }
                else {  // Opera, Google Chrome and Safari
                    alert ("Your browser doesn't support this example!");
                } 
            }
        }
   </script>
</head>
<body>
    <button onclick="AddToFavorites ();">Add to favorites</button>
</body>

Copy Code

Preview

Syntax Highlighter

Did you find this example helpful? yes no

External links:

external (MSDN)

Digg Del.icio.us Reddit Facebook Twitter Diigo

User Contributed Comments

external object

Syntax:

Possible members:

Example HTML code 1:

External links:

Post Content