Windows Media Player SDK banner art
PreviousNext

BANNER Element

The 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 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 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 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 the player is embedded in a Web page.

Example Code

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>

See Also

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.