共用方式為


BitmapImage.AutoPlay 屬性

定義

取得或設定值,這個值表示動畫影像是否應該在載入時立即播放。

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

屬性值

Boolean

bool

如果動畫影像在載入時應該立即播放,則為true;否則為false。 預設值為 True

Windows 需求

裝置系列
Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

範例

此範例示範如何在所有版本的 Windows 10 上執行的應用程式中使用版本調適型程式碼。 在 1607 版之前的版本中,會顯示 GIF 的第一個畫面格,但不會以動畫顯示。

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

備註

從 Windows 10 1607 版開始,XAML Image元素支援動畫 GIF 影像。 當您使用 BitmapImage 做為影像 來源時,您可以存取 BitmapImage API 來控制動畫 GIF 影像的播放。 如需詳細資訊,請參閱 BitmapImage 類別和 動畫 GIF 播放範例的一節。

使用預設為 true的 AutoPlay 屬性,指定動畫點陣圖在載入時是否播放。

注意

對於大部分的應用程式,建議您在UISettings.AnimationsEnabledfalse時將 AutoPlay 設定為false,以支援使用者的協助工具需求。 如果動畫 GIF 的內容對於應用程式的可用性很重要,請勿這麼做。

相容性注意事項

如果您的應用程式在 1607 版之前的Windows 10版本上執行,您必須在程式碼中設定此屬性,並使用ApiInformation類別來檢查此屬性是否存在,才能使用它。 如果您在 XAML 中設定這個屬性,您將會收到 XAML 編譯器錯誤。 如需詳細資訊,請參閱 版本調適型程式碼:使用新的 API,同時維持與舊版的相容性

適用於