Presents a dialog box that enables the user to either add the channel specified, or change the channel URL if it is already installed.

Syntax

window.external.AddChannel(sURLToCDF)

Parameters

sURLToCDF

Required. String that specifies the URL of a Channel Definition Format (CDF) file to be installed.

Return Value

No return value.

Remarks

If the call fails, an error dialog box appears. You can suppress the dialog box by using the onerror event.

Note  This method is intended for use by publishers shipping Microsoft® Active Channel™ content. Active Channel technology is available as of Microsoft Internet Explorer 4.0 and later.

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

Example

This example uses the AddChannel method to present a dialog box that enables the user to add the channel described in the specified CDF file.

window.external.AddChannel("http://domain/folder/file.cdf");

Standards Information

There is no public standard that applies to this method.

Applies To

	external

See Also

Introduction to Active Channel Technology