BitmapImage.Play Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает анимацию анимированного изображения.
public:
virtual void Play() = Play;
void Play();
public void Play();
function play()
Public Sub Play ()
Требования к Windows
Семейство устройств |
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v3.0)
|
Примеры
Вот как использовать ApiInformation.IsMethodPresent для проверка наличия метода Play перед его вызовом.
if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "Play"))
{
imageSource.Play();
}
В этом примере показано, как использовать анимированный GIF-файл. Кнопка позволяет пользователю запускать или останавливать анимацию. Свойство IsPlaying проверяется, чтобы определить, вызывается ли метод Play или Stop для переключения воспроизведения.
В примере используется адаптивный к версии код, который может выполняться во всех версиях Windows 10. В этом случае наличие свойства IsPlaying указывает на то, что также присутствуют методы Play и Stop, поэтому дополнительная проверка API не требуется.
<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 в качестве источника изображения вы можете получить доступ к API BitmapImage для управления воспроизведением анимированного GIF-изображения. Дополнительные сведения см. в разделе "Анимированные изображения" класса BitmapImage Примечания и в примере воспроизведения анимированного GIF-файла.
Используйте свойство IsPlaying вместе с методами Play и Stop , чтобы управлять воспроизведением анимированного растрового изображения.
Заметки о совместимости
Если приложение выполняется в выпусках Windows 10 до версии 1607, необходимо использовать класс ApiInformation для проверка наличия этого метода перед его использованием. Дополнительные сведения см. в статье Версия адаптивного кода: использование новых API при сохранении совместимости с предыдущими версиями.