AddDesktopComponent Method

Adds a Web site or image to the Microsoft® Active Desktop™.

Syntax

window.external.AddDesktopComponent(sURL, sType [, iLeft, iTop, iWidth, iHeight])

Parameters

sURL	Required. String that specifies the location of the Web site or image to be added to the Active Desktop.
sType	Required. String that specifies the type of item to add. The value image specifies the component is an image. The value website specifies the component is a Web site.
iLeft	Optional. Integer that specifies the position of the left edge, in screen coordinates.
iTop	Optional. Integer that specifies the position of the top edge, in screen coordinates.
iWidth	Optional. Integer that specifies the width, in screen units.
iHeight	Optional. Integer that specifies the height, in screen units.

Return Value

No return value.

Remarks

The user must have Active Desktop installed for the AddDesktopComponent method to work. If Active Desktop is not installed, the method is not invoked.

This method is not supported in html applications.

Example

This example uses the AddDesktopComponent method to add the Microsoft Web site as an Active Desktop component.

window.external.AddDesktopComponent(
   "http://www.microsoft.com",
   "website",
   100,100,200,200
);

Applies To

[ Object Name ] Platform Version Win16: Win32: Mac: Unix: WinCE: Version data is listed when the mouse hovers over a link, or the link has focus.	external

Back to top

Did you find this topic useful? Suggestions for other topics? write us!

© 1999 microsoft corporation. all rights reserved. terms of use.