BitmapImage.Stop Methode

Referenz

Definition

Namespace:: Windows.UI.Xaml.Media.Imaging

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.

Bearbeiten

Beendet die Animation eines animierten Bilds.

public:
 virtual void Stop() = Stop;

void Stop();

public void Stop();

function stop()

Public Sub Stop ()

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 Stop-Methode vorhanden ist, bevor Sie sie aufrufen.

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

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:

Freigeben über