BitmapImage.AutoPlay Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah gambar animasi harus diputar segera setelah dimuat.
public:
property bool AutoPlay { bool get(); void set(bool value); };
bool AutoPlay();
void AutoPlay(bool value);
public bool AutoPlay { get; set; }
var boolean = bitmapImage.autoPlay;
bitmapImage.autoPlay = boolean;
Public Property AutoPlay As Boolean
Nilai Properti
bool
true jika gambar animasi harus diputar segera setelah dimuat; jika tidak, salah. Defaultnya adalah true
Persyaratan Windows
Rangkaian perangkat |
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)
|
Contoh
Contoh ini menunjukkan cara menggunakan kode adaptif versi untuk menggunakan properti ini di aplikasi yang berjalan di semua versi Windows 10. Pada versi sebelum versi 1607, bingkai pertama GIF ditampilkan, tetapi tidak dianimasikan.
<Image Loaded="Image_Loaded">
<Image.Source>
<BitmapImage x:Name="imageSource"
UriSource="Assets/example.gif"/>
</Image.Source>
</Image>
// Set the AutoPlay property.
private void Image_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "AutoPlay") == true)
{
imageSource.AutoPlay = false;
}
}
Keterangan
Mulai Windows 10, versi 1607, elemen Gambar XAML mendukung gambar GIF animasi. Saat Anda menggunakan BitmapImage sebagai Sumber gambar, Anda dapat mengakses BITMAPImage API untuk mengontrol pemutaran gambar GIF animasi. Untuk informasi selengkapnya, lihat bagian 'Gambar animasi' dari komentar kelas BitmapImage dan sampel pemutaran GIF Animasi.
Gunakan properti AutoPlay, yang defaultnya ke true, untuk menentukan apakah bitmap animasi diputar atau tidak segera setelah dimuat.
Catatan
Untuk sebagian besar aplikasi, kami sarankan Anda mengatur AutoPlay ke false jika UISettings.AnimationsEnabledsalah, untuk mendukung kebutuhan aksesibilitas pengguna. Jangan lakukan ini jika konten GIF animasi penting untuk kegunaan aplikasi Anda.
Catatan kompatibilitas
Jika aplikasi Anda berjalan pada rilis Windows 10 sebelum versi 1607, Anda harus mengatur properti ini dalam kode dan menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda menggunakannya. Jika Anda mengatur properti ini di XAML, Anda akan mendapatkan kesalahan pengkompilasi XAML. Untuk informasi selengkapnya, lihat Kode adaptif versi: Menggunakan API baru sambil mempertahankan kompatibilitas dengan versi sebelumnya.