BitmapImage.IsPlaying 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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。
示例
此示例演示如何使用动画 GIF。 按钮允许用户启动或停止动画。 选中 IsPlaying 属性以确定是否调用 Play 或 Stop 方法来切换播放。
该示例使用版本自适应代码,因此它可以在所有版本的 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 属性以及 Play 和 Stop 方法来控制动画位图的播放。
兼容性说明
如果你的应用在版本 1607 之前的 Windows 10 版本上运行,则必须使用 ApiInformation 类来检查此属性是否存在。 有关详细信息,请参阅 版本自适应代码:在保持与以前版本的兼容性的同时使用新 API。