External.selectedItemID

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

This topic describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

The selectedItemID property retrieves the identifier of the media item that is currently selected in Windows Media Player.

Syntax

window.external.selectedItemID

Possible Values

This property is a read-only String.

Remarks

This property is used in combination with the External.selectedItemType property. For example, if selectedItemType is equal to CPTrackID, then selectedItemID is the ID of the selected track. For more information about how Windows Media Player characterizes views of online store content, see Location and Selected Item.

Certain views in Windows Media Player have a particular media item that is selected. For example, suppose the current view represents an album. An album is a container of tracks, so selectedItemType is equal to CPTrackID, and selectedItemID is the ID of the selected track. Other views do not have a selected media item. For example, if the user clicks the online store's root node in the tree-view control, Windows Media Player displays a discovery page provided by the online store. The Player does not display any container of media items in the Player user interface. In that case, selectedItemType is equal to UnknownLocation, and selectedItemID is equal to the empty string.

Requirements

Requirement	Value
Version	Windows Media Player 11.
DLL	Wmp.dll

See also

External Object for Type 1 Online Stores

External.selectedItemType

Location and Selected Item