BitmapImage.Play Метод

Определение

Пространство имен:

Windows.UI.Xaml.Media.Imaging

Запускает анимацию анимированного изображения.

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 при сохранении совместимости с предыдущими версиями.