Windows Media Player Control SDK Banner Art
*Contents *Index  *Topic Contents

*Previous Topic: ABSTRACT
*Next Topic: AUTHOR

ASX Element

Defines a file as an Advanced Stream Redirector (ASX) file.

Syntax

<ASX
   VERSION="number"
   PREVIEWMODE= "YES" | "NO"
   BANNERBAR= "AUTO" | "FIXED"
>
</ASX>

Attributes

VERSION (required)
Decimal representing the version number of the syntax for the ASX file.
PREVIEWMODE
Value indicating whether the Microsoft® Windows Media™ Player control enters preview mode before playing the first clip. Possible values include the following.
YES Windows Media Player control enters preview mode.
NO Windows Media Player control does not enter preview mode.
The default value is NO.
BANNERBAR
Value indicating whether the Windows Media Player control reserves space for a banner graphic. Possible values include the following.
AUTO Windows Media Player control reserves space for the banner bar only when a piece of content includes one.
FIXED Windows Media Player control reserves a fixed space for a banner graphic for every piece of content played, whether or not there is an associated banner.
The default value is AUTO.

Parent/Child Information

Parent elements None. The ASX element must be the first element in any ASX file.
Child elements ABSTRACT, AUTHOR, BANNER, BASE, COPYRIGHT, DURATION, ENTRY, ENTRYREF, LOGO, MOREINFO, PREVIEWDURATION, PARAM, REPEAT, TITLE

Remarks

This element defines a file as an ASX file. The first four characters of an ASX file must be <ASX. Other elements defined within the scope of the ASX element, such as TITLE and AUTHOR, are associated with the show information displayed by the Windows Media Player.

For the Windows Media Player, the syntax version number is 3.0. The Windows Media Player supports all previous versions of ASX syntax. Acceptable values for the VERSION attribute include both 3.0 and 3 (with no decimal point).

If the value of the PREVIEWMODE attribute is YES, the Windows Media Player control immediately enters preview mode before playing the first clip. When the Windows Media Player enters preview mode, it previews each clip referenced in the ASX file. The PREVIEWDURATION element determines the duration of the preview.

The BANNERBAR attribute defines whether the Windows Media Player control reserves space for a banner graphic. A banner is a graphic that is displayed in the video display panel while content is playing. (Use the BANNER element to add a banner to the content.) If the value of BANNERBAR is FIXED, the Windows Media Player reserves space for every piece of content, whether or not the content has a banner. If a piece of content does not have a banner associated with it, the space reserved for one is black. If the value of the BANNERBAR attribute is AUTO, the Windows Media Player reserves space for the banner only when a piece of content includes one.

If you create an ASX file with multiple clips (ENTRY or ENTRYREF elements) and set the value of the BANNERBAR attribute to AUTO, the Windows Media Player control might resize to allow space for a banner graphic for one clip, and then resize again if the next clip does not contain a banner graphic. If you want the size of the window to stay the same (except when the video size changes), use the FIXED value for the BANNERBAR attribute.

The space reserved for a banner graphic is 32 pixels high by 194 pixels wide, and appears 6 pixels above the lower edge of the video area, allowing space for the 6-pixel border. The banner is centered horizontally. Note that the minimum width of the Windows Media Player control is always wider than the size of the video clip, regardless of the value of the BANNERBAR attribute.

Example

<ASX VERSION="3.0" PREVIEWMODE="YES" >
   <ENTRY HREF="http://samples.microsoft.com/sample1.asx" />
</ASX>

Top of Page Top of Page
© 1999 Microsoft and/or its suppliers. All rights reserved. Terms of Use.