BitmapImage.AutoPlay Propriété

Définition

Espace de noms:

Microsoft.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.

Exemples

Cet exemple montre comment utiliser le 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 s’affiche, 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 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 Remarks et l’exemple de lecture GIF animée.

Utilisez la propriété Lecture automatique, qui a la valeur true par défaut, pour spécifier si une image 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. Ne le faites pas si le contenu du GIF animé est important pour la facilité d’utilisation 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 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.