BitmapImage.IsPlaying 属性

定义

获取一个值,该值指示是否正在播放动画图像。

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

示例

此示例演示如何使用动画 GIF。 按钮允许用户启动或停止动画。 选中 IsPlaying 属性以确定是否调用 PlayStop 方法来切换播放。

该示例使用版本自适应代码,因此它可以在所有版本的 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();
    }   
}

注解

从 Windows 10 版本 1607 开始,XAML Image 元素支持动态 GIF 图像。 使用 BitmapImage 作为图像 时,可以访问 BitmapImage API 来控制动画 GIF 图像的播放。 有关详细信息,请参阅 BitmapImage 类“备注”和 动画 GIF 播放示例的“动画图像”部分。

使用 IsPlaying 属性以及 PlayStop 方法来控制动画位图的播放。

兼容性说明

如果你的应用在版本 1607 之前的 Windows 10 版本上运行,则必须使用 ApiInformation 类来检查此属性是否存在。 有关详细信息,请参阅 版本自适应代码:在保持与以前版本的兼容性的同时使用新 API

适用于