BitmapImage.AutoPlay Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Media.Imaging

Ruft einen Wert ab, der angibt, ob ein animiertes Bild wiedergegeben werden soll, sobald es geladen wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

bool

TRUE , wenn ein animiertes Bild wiedergegeben werden soll, sobald es geladen wird; Andernfalls false. Der Standardwert ist true.

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

In diesem Beispiel wird gezeigt, wie Sie versionsadaptiven Code verwenden, um diese Eigenschaft in einer App zu verwenden, die unter allen Versionen von Windows 10 ausgeführt wird. In Versionen vor Version 1607 wird der erste Frame des GIF angezeigt, jedoch nicht animiert.

<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;
    }
}

Hinweise

Ab Windows 10 Version 1607 unterstützt das XAML Image-Element animierte GIF-Bilder. Wenn Sie ein 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 Animierte GIF-Wiedergabe.

Verwenden Sie die AutoPlay-Eigenschaft , die standardmäßig auf true festgelegt ist, um anzugeben, ob eine animierte Bitmap beim Laden wiedergegeben wird.

Hinweis

Für die meisten Apps wird empfohlen, autoPlay auf false festzulegen, wenn UISettings.AnimationEnabledauf false festgelegt ist, um die Barrierefreiheitsanforderungen von Benutzern zu unterstützen. Tun Sie dies nicht, wenn der Inhalt des animierten GIF für die Benutzerfreundlichkeit Ihrer App wichtig ist.

Kompatibilitätshinweise

Wenn Ihre App auf Versionen von Windows 10 vor Version 1607 ausgeführt wird, müssen Sie diese Eigenschaft im Code festlegen und die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie verwenden. Wenn Sie diese Eigenschaft in XAML festlegen, erhalten Sie einen XAML-Compilerfehler. Weitere Informationen finden Sie unter Versionsadaptiver Code: Verwenden neuer APIs unter Beibehaltung der Kompatibilität mit früheren Versionen.