Método PlaylistCollection.newPlaylist

  • Artigo

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O novo métodoPlaylist cria uma nova playlist na biblioteca.

Sintaxe

retVal = PlaylistCollection.newPlaylist(
  name
)

Parâmetros

name [in]

Cadeia de caracteres que contém o nome da playlist a ser criada.

Retornar valor

Esse método retorna um objeto Playlist .

Comentários

Esse método cria uma playlist vazia na biblioteca. Para preencher a playlist com itens de mídia, use Playlist. appendItem ou Playlist. insertItem.

Várias playlists com o mesmo nome são permitidas na biblioteca. Para evitar a criação de um nome de playlist duplicado com esse método, use getByName e PlaylistArray. contagem para determinar se já existe uma playlist com um nome específico.

Espaços à esquerda e à direita não são permitidos em nomes de playlist e são removidos automaticamente do valor especificado para o parâmetro name .

Para usar esse método, é necessário acesso completo à biblioteca. Para obter mais informações, consulte Acesso à biblioteca.

Exemplos

O exemplo de JScript a seguir cria uma nova playlist vazia chamada "ThreeList". O objeto Player foi criado com ID="Player".

//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");

Requisitos

Requisito Valor
Versão
 Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL
Wmp.dll

Confira também

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistArray.count

Objeto PlaylistCollection

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection.remove

Settings.mediaAccessRights

Settings.requestMediaAccessRights