PlaylistCollection.newPlaylist メソッド
[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
newPlaylist メソッドは、ライブラリに新しいプレイリストを作成します。
構文
retVal = PlaylistCollection.newPlaylist(
name
)
パラメーター
-
name [in]
-
作成するプレイリストの名前を含む文字列。
戻り値
このメソッドは Playlist オブジェクトを返します。
解説
このメソッドは、ライブラリに空のプレイリストを作成します。 プレイリストにメディアアイテムを入力するには、プレイリストを使用 します。appendItem または Playlist。insertItem。
ライブラリでは、同じ名前の複数のプレイリストを使用できます。 このメソッドで重複するプレイリスト名が作成されないようにするには、 getByName と PlaylistArray を使用します。特定 の名前のプレイリストが既に存在するかどうかを判断します。
先頭と末尾のスペースはプレイリスト名では使用できません。 name パラメーターに指定された値から自動的に削除されます。
このメソッドを使用するには、ライブラリへのフル アクセスが必要です。 詳細については、「 ライブラリ アクセス」を参照してください。
例
次の JScript の例では、"ThreeList" という名前の新しい空のプレイリストを作成します。 Player オブジェクトは ID="Player" で作成されました。
//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");
要件
| 要件 | 値 |
|---|---|
| Version |
バージョン 7.0 以降Windows メディア プレーヤー。 |
| [DLL] |
|
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示