AddDesktopComponent Method

Internet Development Index

---

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

Syntax

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 containing one of the following values that specify the type of item to add. image Specifies the component is an image. 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 this method to work. If Active Desktop is not installed, this method is not invoked.

This method is not supported in HTML Applications (HTAs).

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
);

Standards Information

There is no public standard that applies to this method.

Applies To

	external