BitmapImage.Play 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
애니메이션 이미지의 애니메이션을 시작합니다.
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 사용을 참조하세요.