BitmapImage.IsAnimatedBitmap Propriété

Définition

Obtient une valeur qui indique si une image est animée.

public:
 property bool IsAnimatedBitmap { bool get(); };
bool IsAnimatedBitmap();
public bool IsAnimatedBitmap { get; }
var boolean = bitmapImage.isAnimatedBitmap;
Public ReadOnly Property IsAnimatedBitmap As Boolean

Valeur de propriété

Boolean

bool

true si l’image est animée ; sinon, false.

Configuration requise pour Windows

Famille d’appareils
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Exemples

Cet exemple montre comment utiliser un GIF animé. Un bouton permet à l’utilisateur de démarrer ou d’arrêter l’animation. La propriété IsAnimatedBitmap est vérifiée pour déterminer si le bouton est affiché ou masqué.

L’exemple utilise du code adaptatif de version pour qu’il puisse s’exécuter sur toutes les versions de Windows 10. Sur les versions antérieures à la version 1607, la première image du GIF est affichée, mais elle n’est pas animée.

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

Remarques

À compter de Windows 10, version 1607, l’élément Image XAML prend en charge les images GIF animées. Lorsque vous utilisez une image BitmapImage comme source d’image, vous pouvez accéder à l’API BitmapImage pour contrôler la lecture de l’image GIF animée. Pour plus d’informations, consultez la section « Images animées » de la classe BitmapImage Remarques et l’exemple de lecture gif animée.

Notes de compatibilité

Si votre application s’exécute sur des versions de Windows 10 antérieures à la version 1607, vous devez utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de l’utiliser. Pour plus d’informations, consultez Code adaptatif de version : utiliser de nouvelles API tout en conservant la compatibilité avec les versions précédentes.

S’applique à