BitmapImage.AutoPlay Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Media.Imaging

Ottiene o imposta un valore che indica se un'immagine animata deve essere riprodotta non appena viene caricata.

public:
 property bool AutoPlay { bool get(); void set(bool value); };

bool AutoPlay();

void AutoPlay(bool value);

public bool AutoPlay { get; set; }

var boolean = bitmapImage.autoPlay;
bitmapImage.autoPlay = boolean;

Public Property AutoPlay As Boolean

Valore della proprietà

Boolean

bool

true se un'immagine animata deve essere riprodotta non appena viene caricata; in caso contrario, false. Il valore predefinito è True.

Esempio

In questo esempio viene illustrato come usare il codice adattivo della versione per usare questa proprietà in un'app in esecuzione in tutte le versioni di Windows 10. Nelle versioni precedenti alla versione 1607 viene visualizzata la prima cornice della GIF, ma non è animata.

<Image Loaded="Image_Loaded">
    <Image.Source>
        <BitmapImage x:Name="imageSource"
                     UriSource="Assets/example.gif"/>
    </Image.Source>
</Image>

// Set the AutoPlay property.
private void Image_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "AutoPlay") == true)
    {
        imageSource.AutoPlay = false;
    }
}

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à AutoPlay, che per impostazione predefinita è true, per specificare se una bitmap animata viene riprodotta non appena viene caricata.

Nota

Per la maggior parte delle app, è consigliabile impostare AutoPlay su false se UISettings.AnimationsEnabled è false, per supportare le esigenze di accessibilità degli utenti. Non farlo se il contenuto della GIF animata è importante per l'usabilità dell'app.

Note sulla compatibilità

Se l'app viene eseguita nelle versioni di Windows 10 prima della versione 1607, è necessario impostare questa proprietà nel codice e usare la classe ApiInformation per verificare la presenza di questa proprietà prima di usarla. Se si imposta questa proprietà in XAML, verrà visualizzato un errore del compilatore XAML. Per altre informazioni, vedere Codice adattivo della versione: usare nuove API mantenendo la compatibilità con le versioni precedenti.