Share via


BANNER-Element

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Das BANNER-Element definiert eine URL zu einer Grafikdatei, die im Anzeigebereich angezeigt wird.

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

Attribute

HREF (erforderlich)

URL zu einer Grafikdatei, die im Anzeigebereich angezeigt wird.

Übergeordnete/untergeordnete Elemente

Hierarchy Elemente
Übergeordnete Elemente ASX, EINTRAG
Untergeordnete Elemente ABSTRACT, MEHRINFO

Bemerkungen

Dieses Element definiert eine URL zu einer Grafikdatei, die im Windows Medienwiedergabe Anzeigebereich unterhalb des Videoinhalts angezeigt wird. Wenn es sich bei den Medien nur um Audio handelt, wird die Bannergrafik selbst angezeigt. Windows Medienwiedergabe reserviert einen Bereich mit einer Höhe von 32 Pixeln und einer Breite von 194 Pixeln (die Bannerleiste) für die Grafik. Wenn die in der URL definierte Grafik kleiner ist, wird sie in ihrer ursprünglichen Größe angezeigt. Wenn die Grafik größer als der reservierte Platz ist, schneidet Windows Medienwiedergabe das Bild an den Raum zu.

Sie können ein ABSTRACT-Element im Bereich des BANNER-Elements verwenden, um Text als QuickInfo anzuzeigen, wenn der Benutzer den Mauszeiger über die Bannergrafik anhält. Ein MOREINFO-Element in einem BANNER-Element definiert eine URL, an die der Benutzer weitergeleitet wird, wenn der Benutzer auf die Bannergrafik klickt. (Die URL kann ein beliebiger Pfad oder ein beliebiges Protokoll sein, z. B. ein E-Mail-Link, eine HTTP-URL (Hypertext Transfer Protocol) zu einer Website oder sogar ein Microsoft JScript-Befehl.) Wenn der Zeiger über die Grafik bewegt wird, wird die Grafik geprägt und sieht wie eine Schaltfläche aus.

Ein banner-Element, das für ein ASX-Element definiert ist, wird angezeigt, während alle Clips in der Wiedergabeliste wiedergegeben werden. Ein banner-Element, das in einem ENTRY-Element definiert ist, wird nur angezeigt, während dieser Clip wiedergegeben wird, und überschreibt während dieser Zeit jedes Banner, das innerhalb des übergeordneten ASX-Elements definiert ist. Sie können angeben, wie Windows Medienwiedergabe Speicherplatz für das Banner reserviert, indem Sie das BANNERBAR-Attribut des ASX-Elements festlegen.

Bannerbilder werden bei DRM-Dateien oder bei eingebetteten Windows Medienwiedergabe in eine Webseite nicht unterstützt.

Beispiele

Im Folgenden finden Sie ein Beispiel für ein BANNER-Element ohne untergeordnete Elemente:

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

Im Folgenden finden Sie ein Beispiel für ein BANNER-Element , das ABSTRACT - und MOREINFO-Elemente enthält.

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

Anforderungen

Anforderung Wert
Version
Windows Medienwiedergabe Version 7.0 oder höher

Siehe auch

Referenz zu Windows Media-Metafile-Elementen

Windows Media-Metadateireferenz