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를 사용하는 방법을 보여줍니다. 단추를 사용하면 사용자가 애니메이션을 시작하거나 중지할 수 있습니다. 재생을 전환하기 위해 Play 또는 Stop 메서드를 호출할지 여부를 확인하려면 IsPlaying 속성을 확인합니다.

이 예제에서는 버전 적응 코드를 사용하여 모든 버전의 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를 이미지 원본으로 사용하는 경우 BitmapImage API에 액세스하여 애니메이션 GIF 이미지의 재생을 제어할 수 있습니다. 자세한 내용은 BitmapImage 클래스 설명 및 애니메이션 GIF 재생 샘플의 '애니메이션 이미지' 섹션을 참조하세요.

애니메이션 비트맵의 재생을 제어하려면 Play 및 Stop 메서드와 함께 IsPlaying 속성을 사용합니다.

호환성 정보

앱이 버전 1607 이전의 Windows 10 릴리스에서 실행되는 경우 사용하기 전에 ApiInformation 클래스를 사용하여 이 메서드가 있는지 검사 합니다. 자세한 내용은 버전 적응 코드: 이전 버전과의 호환성을 유지하면서 새 API 사용을 참조하세요.