BitmapImage.AutoPlay Eigenschaft

Referenz

Definition

Namespace:: Microsoft.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

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.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie adaptiven Versionscode 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 der GIF angezeigt, aber 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 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 AutoPlay-Eigenschaft, die standardmäßig auf true festgelegt ist, um anzugeben, ob eine animierte Bitmap beim Laden wiedergegeben wird oder nicht.

Hinweis

Für die meisten Apps wird empfohlen, autoPlay auf false festzulegen, wenn UISettings.AnimationEnabledfalse ist, um die Barrierefreiheitsanforderungen von Benutzern zu unterstützen. Tun Sie dies nicht, wenn der Inhalt der 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 Adaptiver Versionscode: Verwenden neuer APIs unter Beibehaltung der Kompatibilität mit früheren Versionen.

Gilt für:

Freigeben über