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.
imageSpecifies the component is an image.
websiteSpecifies 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