MediaCollection.remove メソッド

  • [アーティクル]

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

remove メソッドは、メディア コレクションから項目を削除します。

構文

MediaCollection.remove(
  item,
  delete
)

パラメーター

item [in]

削除するメディア オブジェクト。

delete [in]

項目を削除するかどうかを示すブール値。

戻り値

このメソッドは値を返しません。

解説

このメソッドは、ライブラリから項目を削除します。 このメソッドは、ユーザーのコンピューターからファイルを削除しません。

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

例

次の JScript の例では、ユーザーにメッセージを表示した後、 MediaCollection を使用してメディア コレクション内の最初のメディア項目を完全に削除します。remove。 Player オブジェクトは ID = "Player" で作成されました。

// Retrieve the first item from the media collection.
var mediaObject = Player.mediaCollection.getAll().item(0);

// Store the name of the retrieved object.
var mediaName = mediaObject.name;

// Prompt the user for permission to delete the object.
var answer = confirm("OK to permanently delete " + mediaName + "?");

// Check the user response.
if (answer){

    // Permanently delete the item.
    Player.mediaCollection.remove(mediaObject, true);

    // Report that the item was deleted.
    alert("Deleted item " + mediaName);
}

必要条件

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

関連項目

Media オブジェクト

MediaCollection オブジェクト

MediaCollection.add

Settings.mediaAccessRights

Settings.requestMediaAccessRights