IWMPPlaylistCollection::newPlaylist メソッド

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

newPlaylist メソッドは、ライブラリ内の新しい空のプレイリストの IWMPPlaylist インターフェイスを返します。

構文

public IWMPPlaylist newPlaylist(
  System.String bstrName
);

Public Function newPlaylist( _
  ByVal bstrName As System.String _
) As IWMPPlaylist
Implements IWMPPlaylistCollection.newPlaylist

パラメーター

bstrName [in]

新しいプレイリストの名前である System.String

戻り値

新しいプレイリストの WMPLib.IWMPPlaylist インターフェイス。

解説

このメソッドは、ライブラリに空のプレイリストを作成します。 プレイリストにメディアアイテムを入力するには、 IWMPPlaylist.appendItem または IWMPPlaylist.insertItem を使用します

ライブラリでは、同じ名前の複数のプレイリストを使用できます。 このメソッドで重複するプレイリスト名が作成されないようにするには、 getByName メソッドと IWMPPlaylistArray.count を使用して、特定の名前のプレイリストが既に存在するかどうかを検出します。

先頭と末尾のスペースはプレイリスト名では許可されず、 bstrName パラメーターに指定された値から自動的に削除されます。

このメソッドを呼び出す前に、ライブラリへのフル アクセス権が必要です。 詳細については、「 ライブラリ アクセス」を参照してください。

次の例では、"ThreeList" という名前の新しい空のプレイリストを作成し、それをプレイリスト コレクションに追加し、インターフェイスを返します。 AxWMPLib.AxWindowsMediaPlayer オブジェクトは、player という名前の変数によって表されます。

// Add a new empty playlist, named ThreeList, to the playlist collection.
WMPLib.IWMPPlaylist newList = player.playlistCollection.newPlaylist("ThreeList");

'  Add a new empty playlist, named ThreeList, to the playlist collection.
Dim newList As WMPLib.IWMPPlaylist = player.playlistCollection.newPlaylist("ThreeList")

要件

要件
Version
Windows メディア プレーヤー 9 シリーズ以降。
名前空間
WMPLib
アセンブリ
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

関連項目

IWMPPlaylist インターフェイス (VB および C#)

IWMPPlaylist.appendItem (VB および C#)

IWMPPlaylist.insertItem (VB および C#)

IWMPPlaylistArray.count (VB および C#)

IWMPPlaylistCollection インターフェイス (VB および C#)

IWMPPlaylistCollection.getByName (VB および C#)