BitmapImage.IsAnimatedBitmap Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Media.Imaging

Mendapatkan nilai yang menunjukkan apakah gambar dianimasikan.

public:
 property bool IsAnimatedBitmap { bool get(); };

bool IsAnimatedBitmap();

public bool IsAnimatedBitmap { get; }

var boolean = bitmapImage.isAnimatedBitmap;

Public ReadOnly Property IsAnimatedBitmap As Boolean

Nilai Properti

Boolean

bool

true jika gambar dianimasikan; jika tidak, salah.

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 GIF animasi. Tombol memungkinkan pengguna memulai atau menghentikan animasi. Properti IsAnimatedBitmap dicentang untuk menentukan apakah tombol ditampilkan atau disembunyikan.

Contohnya menggunakan kode adaptif versi sehingga dapat berjalan pada semua versi Windows 10. Pada versi sebelum versi 1607, bingkai pertama GIF ditampilkan, tetapi tidak dianimasikan.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Image>
        <Image.Source>
            <BitmapImage x:Name="imageSource"
                         UriSource="Assets/example.gif"
                         ImageOpened="imageSource_ImageOpened"/>
        </Image.Source>
    </Image>

    <AppBarButton x:Name="playButton"
              Icon="Play"
              Visibility="Collapsed"
              Click="playButton_Click"/>
</Grid>

// Show the play/stop button if the image is animated.
private void imageSource_ImageOpened(object sender, RoutedEventArgs e)
{
    var bitmapImage = (BitmapImage)sender;
    // At this point you can query whether the image is animated or not.
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsAnimatedBitmap") 
        && bitmapImage.IsAnimatedBitmap == true)
    {
        // Enable the play button
        playButton.Visibility = Visibility.Visible;
    }
}

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.

Catatan kompatibilitas

Jika aplikasi Anda berjalan pada rilis Windows 10 sebelum versi 1607, Anda harus menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum menggunakannya. Untuk informasi selengkapnya, lihat Kode adaptif versi: Menggunakan API baru sambil mempertahankan kompatibilitas dengan versi sebelumnya.