BitmapImage.AutoPlay 속성

정의

네임스페이스:

Windows.UI.Xaml.Media.Imaging

애니메이션 이미지가 로드되는 즉시 재생되어야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

public:
 property bool AutoPlay { bool get(); void set(bool value); };

bool AutoPlay();

void AutoPlay(bool value);

public bool AutoPlay { get; set; }

var boolean = bitmapImage.autoPlay;
bitmapImage.autoPlay = boolean;

Public Property AutoPlay As Boolean

속성 값

Boolean

bool

애니메이션 이미지가 로드되는 즉시 재생되어야 하는 경우 true입니다. 그렇지 않으면 false입니다. 기본값은 true입니다.

Windows 요구 사항

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

예제

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

<Image Loaded="Image_Loaded">
    <Image.Source>
        <BitmapImage x:Name="imageSource"
                     UriSource="Assets/example.gif"/>
    </Image.Source>
</Image>

// Set the AutoPlay property.
private void Image_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Media.Imaging.BitmapImage", "AutoPlay") == true)
    {
        imageSource.AutoPlay = false;
    }
}

설명

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

기본값인 True인 AutoPlay 속성을 사용하여 애니메이션 비트맵이 로드되는 즉시 재생되는지 여부를 지정합니다.

참고

대부분의 앱에서는 사용자의 접근성 요구를 지원하기 위해 UISettings.AnimationsEnabled가 false인 경우 자동 실행을 false로 설정하는 것이 좋습니다. 애니메이션 GIF의 콘텐츠가 앱의 유용성에 중요한 경우 이 작업을 수행하지 마세요.

호환성 정보

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