BitmapImage.AutoPlay Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Media.Imaging

Obtient ou définit une valeur qui indique si une image animée doit être lue dès qu’elle se charge.

public:
 property bool AutoPlay { bool get(); void set(bool value); };

bool AutoPlay();

void AutoPlay(bool value);

public bool AutoPlay { get; set; }

var boolean = bitmapImage.autoPlay;
bitmapImage.autoPlay = boolean;

Public Property AutoPlay As Boolean

Valeur de propriété

Boolean

bool

true si une image animée doit être lue dès qu’elle se charge ; sinon, false. La valeur par défaut est true.

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 du code adaptatif de version pour utiliser cette propriété dans une application qui s’exécute 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.

<Image Loaded="Image_Loaded">
    <Image.Source>
        <BitmapImage x:Name="imageSource"
                     UriSource="Assets/example.gif"/>
    </Image.Source>
</Image>

// Set the AutoPlay property.
private void Image_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "AutoPlay") == true)
    {
        imageSource.AutoPlay = false;
    }
}

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.

Utilisez la propriété Lecture automatique, qui prend par défaut la valeur true, pour spécifier si une bitmap animée est lue dès qu’elle se charge.

Notes

Pour la plupart des applications, nous vous recommandons de définir la lecture automatique sur false si UISettings.AnimationsEnabled a la valeur false, afin de prendre en charge les besoins d’accessibilité des utilisateurs. N’effectuez pas cette opération si le contenu du GIF animé est important pour la convivialité de votre application.

Notes de compatibilité

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