Playlist.item method

[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.]

The item method retrieves the media item at the specified index.

Syntax

retVal = Playlist.item(
  index
)

Parameters

index [in]

Number (long) containing the index of the item to be retrieved.

Return value

This method returns a Media object.

Remarks

To use this method, read access to the library is required. For more information, see Library Access.

Examples

The following JScript example uses Playlist.item to retrieve a media item from the current playlist based on a user selection. An HTML SELECT element was created with name "weblist", and filled with the titles from the current playlist. The Player object was created with ID = "Player".

// Store the value of the selected item in the list box
// using the selectedIndex property.
var index = weblist.selectedIndex;

// Store the corresponding digital media object from the current playlist.
var listItem = Player.currentPlaylist.item(index);

// Set the URL using the listItem variable.
Player.URL = listItem.sourceURL;

Requirements

See also

Media Object

Playlist Object

Playlist.insertItem

Playlist.removeItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights