BANNER Element

Windows Media Player Control SDK Banner Art

Contents Index  Topic Contents

Previous Topic: AUTHOR
Next Topic: BASE

BANNER Element

Defines a URL to a graphic file that will appear in the display panel.

Syntax

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

Attributes

HREF (required): URL to a graphic file that is displayed in the display panel.

Parent/Child Information

Parent elements	ASX, ENTRY
Child elements	ABSTRACT, MOREINFO

Remarks

This element defines a URL to a graphic file that appears in the Microsoft® Windows Media™ Player control's display panel, beneath the video content. If the media is audio only, the banner graphic is displayed by itself. The Windows Media Player control 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, the Windows Media Player control 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 e-mail link, a Hypertext Transfer Protocol (HTTP) URL to a Web site, 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 the Windows Media Player reserves space for the banner by setting the BANNERBAR attribute of the ASX element.

Example

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

<BANNER HREF="http://samples.microsoft.com/art/banner1.bmp" />

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

<BANNER HREF="http://www.servername.com/logos/banner1.bmp">
    <ABSTRACT>Click here to go to our Web site.</ABSTRACT>
    <MOREINFO HREF="http://samples.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>


Contents Index Topic Contents
Previous Topic: AUTHOR Next Topic: BASE