BitmapImage.AutoPlay 屬性

定義

命名空間:

Microsoft.UI.Xaml.Media.Imaging

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

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 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.AnimationsEnabled為false時將 AutoPlay 設定為false，以支援使用者的協助工具需求。 如果動畫 GIF 的內容對於應用程式的可用性很重要，請勿這麼做。

相容性注意事項

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