BitmapImage.IsPlaying 속성

정의

네임스페이스:

Windows.UI.Xaml.Media.Imaging

애니메이션 이미지가 재생되고 있는지 여부를 나타내는 값을 가져옵니다.

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입니다.

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

예제

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

이 예제에서는 버전 적응 코드를 사용하여 모든 버전의 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 재생 샘플의 '애니메이션 이미지' 섹션을 참조하세요.

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

호환성 정보

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