BitmapImage.IsAnimatedBitmap 속성

정의

네임스페이스:

Windows.UI.Xaml.Media.Imaging

이미지에 애니메이션 효과를 주는지 여부를 나타내는 값을 가져옵니다.

public:
 property bool IsAnimatedBitmap { bool get(); };

bool IsAnimatedBitmap();

public bool IsAnimatedBitmap { get; }

var boolean = bitmapImage.isAnimatedBitmap;

Public ReadOnly Property IsAnimatedBitmap As Boolean

속성 값

Boolean

bool

이미지가 애니메이션 효과를 주면 true이고, 그렇지 않으면 false입니다.

Windows 요구 사항

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

예제

이 예제에서는 애니메이션 GIF를 사용하는 방법을 보여줍니다. 단추를 사용하면 사용자가 애니메이션을 시작하거나 중지할 수 있습니다. IsAnimatedBitmap 속성을 확인하여 단추가 표시되는지 숨겨지는지 여부를 확인합니다.

이 예제에서는 버전 적응 코드를 사용하여 모든 버전의 Windows 10 실행할 수 있습니다. 버전 1607 이전 버전에서는 GIF의 첫 번째 프레임이 표시되지만 애니메이션이 적용되지는 않습니다.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Image>
        <Image.Source>
            <BitmapImage x:Name="imageSource"
                         UriSource="Assets/example.gif"
                         ImageOpened="imageSource_ImageOpened"/>
        </Image.Source>
    </Image>

    <AppBarButton x:Name="playButton"
              Icon="Play"
              Visibility="Collapsed"
              Click="playButton_Click"/>
</Grid>

// Show the play/stop button if the image is animated.
private void imageSource_ImageOpened(object sender, RoutedEventArgs e)
{
    var bitmapImage = (BitmapImage)sender;
    // At this point you can query whether the image is animated or not.
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "IsAnimatedBitmap") 
        && bitmapImage.IsAnimatedBitmap == true)
    {
        // Enable the play button
        playButton.Visibility = Visibility.Visible;
    }
}

설명

Windows 10 버전 1607부터 XAML Image 요소는 애니메이션 GIF 이미지를 지원합니다. BitmapImage를 이미지 원본으로 사용하는 경우 BitmapImage API에 액세스하여 애니메이션 GIF 이미지의 재생을 제어할 수 있습니다. 자세한 내용은 BitmapImage 클래스 설명 및 애니메이션 GIF 재생 샘플의 '애니메이션 이미지' 섹션을 참조하세요.

호환성 정보

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