MediaCollection.remove 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
remove 方法會從媒體集合 中移除 專案。
語法
MediaCollection.remove(
item,
delete
)
參數
-
專案 [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);
}
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 7.0 版或更新版本。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應