Controls.isAvailable

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

isAvailable屬性指出是否可以使用指定的資訊類型或可執行指定的動作。

player.controls.isAvailable(
        name
        )

參數

name

包含 下列其中一個值的字串。

字串	描述
currentItem	判斷使用者是否可以設定 currentItem 屬性。
currentMarker	判斷使用者是否可以搜尋特定的標記。
currentPosition	判斷使用者是否可以搜尋檔案中的特定位置。 某些檔案不支援搜尋。
fastForward	判斷檔案是否支援快速轉送，以及是否可以叫用該功能。 許多檔案類型 (或即時串流) 不支援 fastForward。
fastReverse	判斷檔案是否支援 fastReverse，以及是否可以叫用該功能。 許多檔案類型 (或即時串流) 不支援 fastReverse。
下一步	判斷使用者是否可以搜尋播放清單中的下一個專案。
pause	判斷 暫停 方法是否可用。
玩遊戲	判斷 播放 方法是否可用。
previous	判斷使用者是否可以搜尋播放清單中的上一個專案。
步驟	判斷在播放期間是否可使用 步驟 方法。
stop	判斷 stop 方法是否可用。

傳回值

這個方法會傳回 布林 值。

範例

下列範例會建立 HTML BUTTON 元素，以搜尋目前媒體專案的起始位置。 JScript 程式碼會使用 isAvailable 來驗證檔案是否支援搜尋作業。 Player物件是以 ID = 「Player」 建立。

<INPUT TYPE = "BUTTON"  ID = "START"  NAME = "START"  VALUE = "Seek To Zero"

    /* If supported, seek to position zero. */
    onClick = "if (Player.controls.isAvailable('CurrentPosition'))
        Player.controls.currentPosition = 0;
">

規格需求

需求	值
版本	Windows 媒體播放機 7.0 版或更新版本
DLL	Wmp.dll

另請參閱

Controls 物件