BitmapImage.IsPlaying Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une valeur qui indique si une image animée est en cours de lecture.
public:
property bool IsPlaying { bool get(); };
bool IsPlaying();
public bool IsPlaying { get; }
var boolean = bitmapImage.isPlaying;
Public ReadOnly Property IsPlaying As Boolean
Valeur de propriété
bool
true si l’image animée est en cours de lecture ; sinon, false.
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é IsPlaying est vérifiée pour déterminer si la méthode Play ou Stop est appelée pour désactiver la lecture.
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"/>
</Image.Source>
</Image>
<AppBarButton x:Name="playButton"
Icon="Play"
Click="playButton_Click"/>
</Grid>
// Play or stop the animated bitmap.
void playButton_Click(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsPlaying")
&& imageSource.IsPlaying == true)
{
playButton.Icon = new SymbolIcon(Symbol.Play);
imageSource.Stop();
}
else
{
playButton.Icon = new SymbolIcon(Symbol.Stop);
imageSource.Play();
}
}
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é IsPlaying avec les méthodes Play et Stop pour contrôler la lecture d’une bitmap 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.