BitmapImage.Play Metode
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.
Memulai animasi gambar animasi.
public:
virtual void Play() = Play;
void Play();
public void Play();
function play()
Public Sub Play ()
Persyaratan Windows
Rangkaian perangkat |
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)
|
Contoh
Berikut cara menggunakan ApiInformation.IsMethodPresent untuk memeriksa keberadaan metode Play sebelum Anda memanggilnya.
if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "Play"))
{
imageSource.Play();
}
Contoh ini menunjukkan cara menggunakan GIF animasi. Tombol memungkinkan pengguna memulai atau menghentikan animasi. Properti IsPlaying diperiksa untuk menentukan apakah metode Putar atau Hentikan dipanggil untuk mengalihkan pemutaran.
Contohnya menggunakan kode adaptif versi sehingga dapat berjalan pada semua versi Windows 10. Dalam hal ini, keberadaan properti IsPlaying menunjukkan bahwa metode Play and Stop juga ada, sehingga pemeriksaan API tambahan tidak diperlukan.
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<Image>
<Image.Source>
<BitmapImage x:Name="imageSource"
UriSource="Assets/example.gif"/>
</Image.Source>
</Image>
<AppBarButton x:Name="playButton"
Icon="Play"
Click="playButton_Click"/>
</Grid>
// Play or stop the animated bitmap.
void playButton_Click(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsPlaying")
&& imageSource.IsPlaying == true)
{
playButton.Icon = new SymbolIcon(Symbol.Play);
imageSource.Stop();
}
else
{
playButton.Icon = new SymbolIcon(Symbol.Stop);
imageSource.Play();
}
}
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 IsPlaying bersama dengan metode Putar dan Hentikan untuk mengontrol pemutaran bitmap animasi.
Catatan kompatibilitas
Jika aplikasi Anda berjalan pada rilis Windows 10 sebelum versi 1607, Anda harus menggunakan kelas ApiInformation untuk memeriksa keberadaan metode ini sebelum menggunakannya. Untuk informasi selengkapnya, lihat Kode adaptif versi: Menggunakan API baru sambil mempertahankan kompatibilitas dengan versi sebelumnya.