BitmapImage.IsAnimatedBitmap Eigenschaft

Referenz

Definition

Namespace:: Windows.UI.Xaml.Media.Imaging

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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.

Gilt für:

Freigeben über