BitmapImage.IsAnimatedBitmap Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Media.Imaging

Ruft einen Wert ab, der angibt, ob ein Bild animiert wird.

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

bool IsAnimatedBitmap();

public bool IsAnimatedBitmap { get; }

var boolean = bitmapImage.isAnimatedBitmap;

Public ReadOnly Property IsAnimatedBitmap As Boolean

Eigenschaftswert

Boolean

bool

TRUE , wenn das Bild animiert ist; Andernfalls false.

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Beispiele

In diesem Beispiel wird gezeigt, wie ein animiertes GIF verwendet wird. Mit einer Schaltfläche kann der Benutzer die Animation starten oder beenden. Die IsAnimatedBitmap-Eigenschaft wird überprüft, um zu bestimmen, ob die Schaltfläche angezeigt oder ausgeblendet wird.

Im Beispiel wird versionsadaptiven Code verwendet, damit er unter allen Versionen von Windows 10 ausgeführt werden kann. In Versionen vor Version 1607 wird der erste Frame des GIF angezeigt, jedoch nicht animiert.

<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;
    }
}

Hinweise

Ab Windows 10 Version 1607 unterstützt das XAML Image-Element animierte GIF-Bilder. Wenn Sie ein BitmapImage als Bildquelle verwenden, können Sie auf die BitmapImage-API zugreifen, um die Wiedergabe des animierten GIF-Bilds zu steuern. Weitere Informationen finden Sie im Abschnitt "Animierte Bilder" der BitmapImage-Klasse Hinweise und im Beispiel für die Animierte GIF-Wiedergabe.

Kompatibilitätshinweise

Wenn Ihre App in Releases von Windows 10 vor Version 1607 ausgeführt wird, müssen Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie verwenden. Weitere Informationen finden Sie unter Versionsadaptiver Code: Verwenden neuer APIs unter Beibehaltung der Kompatibilität mit früheren Versionen.