BANNER Element

Article
4/26/2023

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The BANNER element defines a URL to a graphic file that will appear in the display panel.

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

Attributes

HREF (required)

URL to a graphic file that is displayed in the display panel.

Parent/Child Elements

Hierarchy	Elements
Parent elements	ASX, ENTRY
Child elements	ABSTRACT, MOREINFO

Remarks

This element defines a URL to a graphic file that appears in the Windows Media Player display panel, beneath the video content. If the media is audio only, the banner graphic is displayed by itself. Windows Media Player reserves a space 32 pixels high by 194 pixels wide (the banner bar) for the graphic. If the graphic defined in the URL is smaller than that, it displays at its original size. If the graphic is larger than the reserved space, Windows Media Player will crop the image to fit the space.

You can use an ABSTRACT element within the scope of the BANNER element to display text as a ToolTip when the user pauses the mouse pointer over the banner graphic. A MOREINFO element within a BANNER element defines a URL to which the user is taken when the user clicks the banner graphic. (The URL can be any path or protocol, such as an email link, a Hypertext Transfer Protocol (HTTP) URL to a website, or even a Microsoft JScript command.) When the pointer is moved over the graphic, the graphic becomes embossed and looks like a button.

A BANNER element defined for an ASX element displays while all clips in the playlist are playing. A BANNER element defined in an ENTRY element displays only while that clip is playing, and during that time overrides any banner defined within the parent ASX element. You can specify how Windows Media Player reserves space for the banner by setting the BANNERBAR attribute of the ASX element.

Banner images are not supported with DRM files or when Windows Media Player is embedded in a webpage.

Examples

The following is an example of a BANNER element without child elements:

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

The following is an example of a BANNER element containing ABSTRACT and MOREINFO elements.

<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>

Requirements

Requirement	Value
Version	Windows Media Player version 7.0 or later

Partager via