BitmapImage.IsPlaying Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob ein animiertes Bild wiedergegeben wird.
public:
property bool IsPlaying { bool get(); };
bool IsPlaying();
public bool IsPlaying { get; }
var boolean = bitmapImage.isPlaying;
Public ReadOnly Property IsPlaying As Boolean
Eigenschaftswert
bool
true , wenn das animierte Bild wiedergegeben wird; andernfalls false.
Windows-Anforderungen
Gerätefamilie |
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
|
Beispiele
In diesem Beispiel wird die Verwendung einer animierten GIF veranschaulicht. Mit einer Schaltfläche kann der Benutzer die Animation starten oder beenden. Die IsPlaying-Eigenschaft wird aktiviert, um zu bestimmen, ob die Play- oder Stop-Methode aufgerufen wird, um die Wiedergabe umzuschalten.
Im Beispiel wird adaptiver Versionscode verwendet, damit er in allen Versionen von Windows 10 ausgeführt werden kann. In Versionen vor Version 1607 wird der erste Frame der GIF angezeigt, aber nicht animiert.
<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();
}
}
Hinweise
Ab Windows 10 Version 1607 unterstützt das XAML Image-Element animierte GIF-Bilder. Wenn Sie bitmapImage als Bildquelle verwenden, können Sie auf die BitmapImage-API zugreifen, um die Wiedergabe des animierten GIF-Bilds zu steuern. Weitere Informationen finden Sie im Abschnitt "Animierte Bilder" der BitmapImage-Klasse Hinweise und im Beispiel für die Wiedergabe animierter GIF.
Verwenden Sie die IsPlaying-Eigenschaft zusammen mit den Play- und Stop-Methoden, um die Wiedergabe einer animierten Bitmap zu steuern.
Kompatibilitätshinweise
Wenn Ihre App in Versionen von Windows 10 vor Version 1607 ausgeführt wird, müssen Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie verwenden. Weitere Informationen finden Sie unter Adaptiver Versionscode: Verwenden neuer APIs unter Beibehaltung der Kompatibilität mit früheren Versionen.