BitmapImage.Play Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Media.Imaging

Avvia l'animazione di un'immagine animata.

public:
 virtual void Play() = Play;

void Play();

public void Play();

function play()

Public Sub Play ()

Esempio

Ecco come usare ApiInformation.IsMethodPresent per verificare la presenza del metodo Play prima di chiamarlo.

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

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 selezionata per determinare se il metodo Play o Stop viene chiamato per attivare o disattivare la riproduzione.

L'esempio usa il codice adattivo della versione in modo che possa essere eseguito in tutte le versioni di Windows 10. In questo caso, la presenza della proprietà IsPlaying indica che sono presenti anche i metodi Play e Stop , pertanto non è necessario un controllo API aggiuntivo.

<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 dell'immagine, è possibile accedere all'API BitmapImage per controllare la riproduzione dell'immagine GIF animata. Per altre info, vedi la sezione 'Animated images' 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, devi usare la classe ApiInformation per verificare la presenza di questo metodo prima di usarla. Per altre info, vedi Codice adattivo della versione: usare le nuove API mantenendo la compatibilità con le versioni precedenti.