AmbientAttributes.clippingImage

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Atribut clippingImage menentukan atau mengambil wilayah untuk mengklip kontrol.

        elementID.clippingImage

Kemungkinan Nilai

Atribut ini adalah String baca/tulis yang menunjukkan nama file gambar. Ini tidak memiliki nilai default.

Keterangan

Atribut clippingImage mendukung file PNG, JPG, BMP, dan GIF (tidak termasuk GIF animasi). Karena JPG bersifat lossy dan karenanya tunduk pada perubahan warna yang tidak terduga, mereka tidak disarankan untuk mengklip gambar.

Atribut ini berguna ketika Anda hanya ingin menampilkan bagian dari gambar kontrol dan bukan seluruh area persegi panjang. Atribut clippingColor menunjukkan wilayah gambar kliping yang sesuai dengan bagian kontrol yang transparan dan tidak dapat diklik. Oleh karena itu, kontrol dapat berbentuk apa pun. Untuk hasil terbaik, gambar kliping harus berukuran sama dengan gambar kontrol.

Atribut clippingImage tidak didukung oleh elemen PLAYLIST, VIEW, dan SUBVIEW . Gambar kliping tidak akan berfungsi dengan elemen VIDEO jika VIDEO. windowless diatur ke false, atau dengan elemen EFFECTS jika EFFECTS. windowed diatur ke true.

Karena penggunaan kliping gambar memberlakukan penalti performa, mereka tidak boleh digunakan ketika efisiensi adalah masalah.

Contoh

Lihat atribut BUTTONELEMENT.mappingColor untuk sampel yang mengilustrasikan penggunaan atribut ini.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru

Lihat juga

Atribut Sekitar

AmbientAttributes.clippingColor