AmbientAttributes.clippingImage

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'attributo clippingImage specifica o recupera l'area in cui ritagliare il controllo.

        elementID.clippingImage

Valori possibili

Questo attributo è una stringa di lettura/scrittura che indica il nome del file di immagine. e non prevede alcun valore predefinito.

Commenti

L'attributo clippingImage supporta file PNG, JPG, BMP e GIF (non incluse le GIF animate). Poiché i gruppi di sicurezza di rete sono persi e quindi soggetti a modifiche di colore impreviste, non sono consigliati per ritagliare immagini.

Questo attributo è utile quando si vuole visualizzare solo una parte dell'immagine del controllo e non l'intera area rettangolare. L'attributo clippingColor indica le aree dell'immagine di ritaglio che corrispondono a parti trasparenti e non clickable del controllo. Il controllo può quindi essere di qualsiasi forma. Per ottenere risultati ottimali, l'immagine di ritaglio deve essere la stessa dimensione dell'immagine del controllo.

L'attributo clippingImage non è supportato dagli elementi PLAYLIST, VIEW e SUBVIEW . Un'immagine di ritaglio non funzionerà con l'elemento VIDEO se VIDEO. windowless è impostato su false, né con l'elemento EFFECTS se EFFECTS. windowed è impostato su true.

Poiché l'uso delle immagini di ritaglio impone una penalità delle prestazioni, non deve essere usato quando l'efficienza è un problema.

Esempio

Vedere l'attributo BUTTONELEMENT.mappingColor per un esempio che illustra l'uso di questo attributo.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva

Vedi anche

Attributi di ambiente

AmbientAttributes.clippingColor