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

*Previous Topic: ENTRY
*Next Topic: EVENT

ENTRYREF Element

Links to the ENTRY elements in an external Advanced Stream Redirector (ASX) file

Syntax

<ENTRYREF
   HREF="URL"
   CLIENTBIND= "YES" | "NO"
/>

Attributes

HREF (required)
URL to a referenced ASX file.
CLIENTBIND
Value indicating whether the user can add the URL defined in the HREF attribute to the Favorites list in the Microsoft® Windows Media™ Player. Possible values include the following.
YESUser can add the URL to the Favorites list.
NOUser cannot add the URL to the Favorites list.
The default value is YES.

Parent/Child Information

Parent elements ASX, EVENT, REPEAT
Child elements None

Remarks

This element points the contents of an external ASX file. The Windows Media Player control processes the ENTRY elements of the referenced ASX file as if they were included in the primary ASX file at the position of the ENTRYREF element. However, it skips any ENTRY elements in the referenced ASX file that have the SKIPIFREF attribute set to YES.

The Windows Media Player control ignores any ENTRYREF elements in the referenced ASX file. Thus, ASX files can only be nested one level deep. The Windows Media Player also ignores the ASX element in the referenced file along with its attributes.

If a user adds a Favorites entry to a piece of content defined in the included ASX file, the Windows Media Player uses the URL to the ASX file referenced in the ENTRYREF element. If the value of the CLIENTBIND attribute is NO, the user cannot add a Favorites entry to this URL. This attribute also determines whether the user can drag an icon from the display panel to create a shortcut to the content.

Examples

<ASX VERSION="3.0">
   <TITLE>Example of Using EntryRef</TITLE>
   <ENTRYREF HREF="http://samples.microsoft.com/metafile.asx" CLIENTBIND="NO" />
</ASX>

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