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

注釈

バージョン 1607 Windows 10以降、XAML Image 要素はアニメーション GIF イメージをサポートしています。 Image Source として BitmapImage を使用すると、BitmapImage API にアクセスして、アニメーション GIF イメージの再生を制御できます。 詳細については、「 BitmapImage クラス解説」の「アニメーション画像」セクションと アニメーション GIF 再生サンプルを参照してください。

アニメーション化されたビットマップが読み込まれるとすぐに再生するかどうかを指定するには、AutoPlay プロパティ (既定値は true) を使用します。

注意

ほとんどのアプリでは、ユーザーのアクセシビリティのニーズをサポートするために、UISettings.AnimationsEnabled が false の場合は AutoPlay を false に設定することをお勧めします。 アニメーション GIF のコンテンツがアプリの使いやすさにとって重要な場合は、この操作を行わないでください。

互換性に関する注意事項

アプリがバージョン 1607 より前のWindows 10のリリースで実行されている場合は、コードでこのプロパティを設定し、ApiInformation クラスを使用して、このプロパティが存在するようにチェックしてから使用する必要があります。 XAML でこのプロパティを設定すると、XAML コンパイラ エラーが発生します。 詳細については、「 バージョン アダプティブ コード: 以前のバージョンとの互換性を維持しながら新しい API を使用する」を参照してください。