BitmapImage.AutoPlay Propriété

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é

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

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

S’applique à