Freigeben über


BitmapImage.Play Methode

Definition

Startet die Animation eines animierten Bilds.

public:
 virtual void Play() = Play;
void Play();
public void Play();
function play()
Public Sub Play ()

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

Hier erfahren Sie, wie Sie apiInformation.IsMethodPresent verwenden, um zu überprüfen, ob die Play-Methode vorhanden ist, bevor Sie sie aufrufen.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "Play"))
{
    imageSource.Play();
}

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 diesem Fall gibt das Vorhandensein der IsPlaying-Eigenschaft an, dass auch die Play - und Stop-Methoden vorhanden sind, sodass keine zusätzliche API-Überprüfung erforderlich ist.

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

Gilt für: