BitmapImage.IsPlaying Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore che indica se viene riprodotta un'immagine animata.
public:
property bool IsPlaying { bool get(); };
bool IsPlaying();
public bool IsPlaying { get; }
var boolean = bitmapImage.isPlaying;
Public ReadOnly Property IsPlaying As Boolean
Valore della proprietà
bool
true se l'immagine animata viene riprodotta; in caso contrario, false.
Requisiti Windows
Famiglia di dispositivi |
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
|
Esempio
In questo esempio viene illustrato come usare una GIF animata. Un pulsante consente all'utente di avviare o arrestare l'animazione. La proprietà IsPlaying viene controllata per determinare se il metodo Play o Stop viene chiamato per attivare la riproduzione.
L'esempio usa il codice adattivo della versione in modo che possa essere eseguito in tutte le versioni di Windows 10. Nelle versioni precedenti alla versione 1607 viene visualizzata la prima cornice della GIF, ma non è animata.
<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();
}
}
Commenti
A partire da Windows 10 versione 1607, l'elemento Image XAML supporta immagini GIF animate. Quando si usa bitmapImage come origine immagine, è possibile accedere all'API BitmapImage per controllare la riproduzione dell'immagine GIF animata. Per altre informazioni, vedere la sezione "Immagini animate" della classe BitmapImage Osservazioni e l'esempio di riproduzione GIF animata.
Utilizzare la proprietà IsPlaying insieme ai metodi Play e Stop per controllare la riproduzione di una bitmap animata.
Note sulla compatibilità
Se l'app viene eseguita nelle versioni di Windows 10 precedenti alla versione 1607, è necessario usare la classe ApiInformation per verificare la presenza di questa proprietà prima di usarla. Per altre informazioni, vedere Codice adattivo della versione: usare nuove API mantenendo la compatibilità con le versioni precedenti.