Player.CurrentPlaylistChange イベント

  • [アーティクル]

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

CurrentPlaylistChange イベントは、現在のプレイリスト内で何かが変更されたときに発生します。

構文

Player.CurrentPlaylistChange(
  change
)

パラメーター

change

プレイリストに対して発生した変更の種類を示す数値 (長)。 プレーヤーを参照してください。指定できる値のテーブルの PlaylistChange イベント。

戻り値

このイベントでは値は返されません。

解説

このイベントは、別のプレイリストが現在のプレイリストになったときには発生しません。 これは、現在のプレイリスト内で変更が発生した場合 (プレイリストに追加されるメディアアイテムなど) にのみ発生します。

イベント パラメーターの値は Windows メディア プレーヤー で指定され、指定されたパラメーター名を使用して、インポートされた JScript ファイル内のメソッドにアクセスしたり、メソッドに渡したりできます。 このパラメーター名は、大文字と小文字を含めて、示されているとおりに入力する必要があります。

例

次の JScript の例では、PlItems という名前の HTML DIV 要素のテキストを更新して、現在のプレイリスト内のメディア項目の名前を表示します。 Player オブジェクトは ID = "Player" で作成されました。

<!-- Create an event handler for current playlist change. -->
<SCRIPT FOR = "Player" EVENT = "currentPlaylistChange(change)">
   switch (change){
      // Only update for move, delete, insert, and append events.
      case 3, 4, 5, 6:

         // Clear the contents of the DIV.
         PlItems.innerHTML = "";

         // Loop through the playlist and display each item name.
         for (var i = 0; i < Player.currentPlaylist.count; i++){
            PlItems.innerHTML += Player.currentPlaylist.item(i).name;
            PlItems.innerHTML += "<br>";
         }
         break;
      
      default:
   } 
</SCRIPT>

要件

要件 値
Version
 バージョン 7.0 以降Windows メディア プレーヤー。
[DLL]
Wmp.dll

関連項目

Player オブジェクト

Player.currentPlaylist

Player.PlaylistChange