AmbientAttributes.clippingImage

  • Artikel

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

Das clippingImage-Attribut gibt die Region an, in die das Steuerelement ausgeschnitten werden soll, oder ruft sie ab.

        elementID.clippingImage

Mögliche Werte

Bei diesem Attribut handelt es sich um eine Zeichenfolge mit Lese-/Schreibzugriff, die den Namen der Imagedatei angibt. Er besitzt keinen Standardwert.

Bemerkungen

Das clippingImage-Attribut unterstützt PNG-, JPG-, BMP- und GIF-Dateien (ohne animierte GIFs). Da JPGs verlustbehaftet sind und daher unerwarteten Farbänderungen unterliegen, werden sie nicht für das Ausschneiden von Bildern empfohlen.

Dieses Attribut ist nützlich, wenn Sie nur einen Teil des Steuerelementbilds und nicht den gesamten rechteckigen Bereich anzeigen möchten. Das clippingColor-Attribut gibt die Bereiche des Clippingbilds an, die transparenten, nicht klickbaren Teilen des Steuerelements entsprechen. Das Steuerelement kann daher eine beliebige Form aufweisen. Um optimale Ergebnisse zu erzielen, sollte das Clippingbild die gleiche Größe wie das Steuerelementbild aufweisen.

Das clippingImage-Attribut wird von den Elementen PLAYLIST, VIEW und SUBVIEW nicht unterstützt. Ein Clipping-Bild funktioniert nicht mit dem VIDEO-Element , wenn VIDEO. windowless ist auf false festgelegt, oder mit dem EFFECTS-Element , wenn EFFECTS. windowed ist auf true festgelegt.

Da die Verwendung von Abschneidbildern eine Leistungsstrafe bedeutet, sollten sie nicht verwendet werden, wenn die Effizienz ein Problem darstellt.

Beispiele

Ein Beispiel, das die Verwendung dieses Attributs veranschaulicht, finden Sie im Attribut BUTTONELEMENT.mappingColor .

Anforderungen

Anforderung Wert
Version
 Windows Medienwiedergabe Version 7.0 oder höher

Siehe auch

Umgebungsattribute

AmbientAttributes.clippingColor