BitmapImage.AutoPlay Proprietà

Definizione

Spazio dei nomi:

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Esempio

Questo esempio illustra come usare il codice adattivo della versione per usare questa proprietà in un'app eseguita in tutte le versioni di Windows 10. Nelle versioni precedenti alla versione 1607 viene visualizzato il primo fotogramma della GIF, ma non è animato.

<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 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à 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 eseguire questa operazione 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 precedenti alla versione 1607, devi impostare questa proprietà nel codice e usare la classe ApiInformation per verificare la presenza di questa proprietà prima di usarla. Se imposti questa proprietà in XAML, riceverai un errore del compilatore XAML. Per altre info, vedi Codice adattivo della versione: usare le nuove API mantenendo la compatibilità con le versioni precedenti.