BitmapImage.AutoPlay Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Media.Imaging

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

Boolean

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.