BANNER 元素

  • 發行項

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

BANNER元素會定義顯示在顯示面板中之圖形檔案的 URL。

<BANNER
   HREF = "URL"
>
</BANNER>

屬性

需要 HREF ()

顯示在顯示面板中之圖形檔案的 URL。

父元素/子項目

階層 元素
父元素 ASX， ENTRY
子元素 ABSTRACT、 MOREINFO

備註

這個專案會定義顯示在影片內容下方Windows 媒體播放機顯示面板中之圖形檔案的 URL。 如果媒體只是音訊，橫幅圖形本身就會顯示。 Windows 媒體播放機保留 32 圖元高 194 圖元寬的空間， (圖形的橫幅列) 。 如果 URL 中定義的圖形小於該圖形，則會以原始大小顯示。 如果圖形大於保留空間，Windows 媒體播放機將會裁剪影像以符合空間。

您可以在BANNER元素的範圍內使用ABSTRACT元素，在使用者暫停橫幅圖形上的滑鼠指標時，將文字顯示為工具提示。 BANNER元素內的MOREINFO元素會定義當使用者按一下橫幅圖形時，會取得使用者的 URL。 (URL 可以是任何路徑或通訊協定，例如電子郵件連結、超文字傳輸通訊協定 (HTTP) URL，甚至是 Microsoft JScript 命令。) 當指標移至圖形上方時，圖形會變成浮凸，看起來像是按鈕。

針對 ASX元素定義的BANNER元素會在播放播放清單中的所有剪輯時顯示。 在 ENTRY元素中定義的BANNER元素只會在播放該剪輯時顯示，而且在該期間會覆寫父ASX元素內定義的任何橫幅。 您可以藉由設定ASX專案的BANNERBAR屬性，指定Windows 媒體播放機保留橫幅的空間。

DRM 檔案或Windows 媒體播放機內嵌在網頁時，不支援橫幅影像。

範例

以下是沒有子項目的 BANNER 元素範例：

<BANNER HREF="https://sample.microsoft.com/art/banner1.bmp" />

以下是包含ABSTRACT和MOREINFO元素的BANNER元素範例。

<BANNER HREF="https://www.proseware.com/logos/banner1.bmp">
    <ABSTRACT>Click here to go to our website.</ABSTRACT>
    <MOREINFO HREF="https://sample.microsoft.com" />
    <!-- The text in the Abstract element displays as a 
         ToolTip when the mouse hovers over the banner 
         graphic. When a user clicks the banner, the URL 
         given in the MoreInfo element opens in the 
         browser. -->
</BANNER>

規格需求

需求 值
版本
 Windows 媒體播放機 7.0 版或更新版本

另請參閱

Windows Media 中繼檔元素參考

Windows Media 中繼檔參考