BitmapImage.AutoPlay プロパティ

定義

名前空間:

Windows.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 の要件

デバイス ファミリ	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;
    }
}

注釈

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

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

注意

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

互換性に関するメモ

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