MediaCollection.getByName メソッド
[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
getByName メソッドは、指定した名前のメディア 項目のプレイリストを取得します。
構文
retVal = MediaCollection.getByName(
name
)
パラメーター
-
name [in]
-
名前を含む文字列。
戻り値
このメソッドは Playlist オブジェクトを返します。
解説
このメソッドを使用するには、ライブラリへの読み取りアクセスが必要です。 詳細については、「 ライブラリ アクセス」を参照してください。
例
次の JScript の例では 、MediaCollection を使用します。ライブラリから 3 つの項目を取得する getByName 。 その後、各項目が現在のプレイリストに追加されます。 Player オブジェクトは ID="Player" で作成されました。
// In each case, use the name exactly as it appears in the library.
// Windows Media Player does not include file name extensions or file paths
// in the name. Internet URLs include the entire path, but not the
// file name extension.
// Get a playlist object that contains an Internet URL.
var One = Player.mediaCollection.getByName("https://www.proseware.com/Media/Laure");
// Get a playlist object that contains a file on a network server.
var Two = Player.mediaCollection.getByName("Jeanne");
// Get a playlist object that contains a file on a local drive.
var Three = Player.mediaCollection.getByName("house");
// Append each item to the current playlist. Since each playlist retrieved
// using getByName contains one digital media item, use Playlist.item with
// an index of zero to reference that item.
Player.currentPlaylist.appendItem(One.item(0));
Player.currentPlaylist.appendItem(Two.item(0));
Player.currentPlaylist.appendItem(Three.item(0));
必要条件
要件 | 値 |
---|---|
Version |
バージョン 7.0 以降をWindows メディア プレーヤーします。 |
[DLL] |
|
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示