BitmapImage.IsPlaying プロパティ

リファレンス

定義

名前空間:: Windows.UI.Xaml.Media.Imaging

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

アニメーション化されたイメージが再生されているかどうかを示す値を取得します。

public:
 property bool IsPlaying { bool get(); };

bool IsPlaying();

public bool IsPlaying { get; }

var boolean = bitmapImage.isPlaying;

Public ReadOnly Property IsPlaying As Boolean

プロパティ値

Boolean

bool

アニメーション画像が再生されている場合は true。それ以外の場合は false。

Windows の要件

デバイスファミリ	Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v3.0 で導入)

例

この例では、アニメーション GIF の使用方法を示します。ボタンを使用すると、ユーザーはアニメーションを開始または停止できます。再生を切り替えるために Play メソッドまたは Stop メソッドを呼び出すかどうかを判断するには、IsPlaying プロパティがオンになっています。

この例では、バージョンアダプティブコードを使用して、すべてのバージョンのWindows 10で実行できます。バージョン 1607 より前のバージョンでは、GIF の最初のフレームが表示されますが、アニメーション化されません。

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Image>
        <Image.Source>
            <BitmapImage x:Name="imageSource"
                         UriSource="Assets/example.gif"/>
        </Image.Source>
    </Image>

    <AppBarButton x:Name="playButton"
              Icon="Play"
              Click="playButton_Click"/>
</Grid>

// Play or stop the animated bitmap.
void playButton_Click(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsPlaying") 
        && imageSource.IsPlaying == true)
    {
        playButton.Icon = new SymbolIcon(Symbol.Play);
        imageSource.Stop();
    }
    else
    {
        playButton.Icon = new SymbolIcon(Symbol.Stop);
        imageSource.Play();
    }   
}

注釈

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

アニメーションビットマップの再生を制御するには、 IsPlaying プロパティと Play メソッドと Stop メソッドを使用します。

互換性に関する注意事項

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

適用対象