피드백

UIElement.CacheMode 속성

  • 참조

정의

네임스페이스:
Windows.UI.Xaml
편집

가능한 경우 렌더링된 콘텐츠를 복합 비트맵으로 캐시해야 임을 나타내는 값을 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.UIElement.CacheMode(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public:
 property CacheMode ^ CacheMode { CacheMode ^ get(); void set(CacheMode ^ value); };
CacheMode CacheMode();

void CacheMode(CacheMode value);
public CacheMode CacheMode { get; set; }
var cacheMode = uIElement.cacheMode;
uIElement.cacheMode = cacheMode;
Public Property CacheMode As CacheMode
<uiElement CacheMode="BitmapCache" />

속성 값

CacheMode

가능한 경우 렌더링된 콘텐츠를 복합 비트맵으로 캐시해야 임을 나타내는 값입니다. GPU(그래픽 처리 장치)에서 RenderTransform 렌더링 작업 값을 CacheMode지정하고 Opacity 실행(사용 가능한 경우)합니다. 기본값은 null 이며 캐시된 컴퍼지션 모드를 사용하도록 설정하지 않습니다.

설명

GPU(그래픽 처리 장치)로 비트맵을 오프로드 RenderTransform 하는 Opacity 캐싱 동작을 사용하도록 설정하려면 이 값을 설정합니다. 그렇지 않으면 null 로 둡니다.

XAML의 경우 문자열 리터럴 "BitmapCache"는 CacheMode를 특성으로 설정하는 데 사용할 수 있는 유일한 사용 값입니다.

참고

BitmapCache는 이 동작을 사용하도록 설정하는 Windows 런타임 API의 유일한 실제 파생 클래스입니다(CacheMode형식은 인프라 및 레거시 이유로만 존재하는 중간 형식).

코드에서 CacheMode를 설정하는 경우 다음과 같이 새 값 BitmapCache으로 설정합니다.

<Canvas x:Name="canvas1"/>

canvas1.CacheMode = new BitmapCache();

#include <winrt/Windows.UI.Xaml.Media.h>
...
canvas1().CacheMode(Windows::UI::Xaml::Media::BitmapCache{});

canvas1->CacheMode = ref new BitmapCache();

먼저 테스트 및 프로파일링하지 않고는 일반적으로 CacheMode 값을 요소에 적용하지 마세요. GPU(그래픽 처리 장치)에 대한 캐싱은 앱에 대해 가능한 렌더링 상황의 소수에 대해서만 사용되며, UI에서 CacheMode 설정을 적용할 시기와 위치의 다양한 조합을 프로파일링할 것으로 예상됩니다. CacheMode를 과도하게 사용하면 성능이 저하될 수 있습니다. 앱 노출 영역을 프로파일링하여 렌더링하는 데 가장 비용이 많이 드는 대상 영역을 확인하고 해당 결과에 따라 특정 요소만 캐싱하는 것을 실험하는 것이 가장 좋습니다. 렌더링을 위해 프로파일링하는 방법에 대한 자세한 내용은 XAML 태그 최적화 항목의 "정적 콘텐츠 캐시" 섹션을 참조 IsOverdrawHeatMapEnabled 하세요.

애니메이션을 함께 사용하고 CacheMode 스토리보드하지 마십시오. 애니메이션이 0인 경우에도 애니메이션이 종속 애니메이션이 되는 위치 또는 RenderTransform 애니메이션이 있는 Opacity 콘텐츠를 캐싱합니다. 이러한 애니메이션이 실행되는 것을 확인하려면 EnableDependentAnimation 을 true 로 설정해야 하며 종속 애니메이션은 일반적으로 컴퍼지션 캐싱에서 얻을 수 있는 모든 성능 향상을 무효화합니다. Opacity 컨트롤 템플릿의 시각적 상태에 의해 애니메이션이 적용되는 경우가 많으므로 XAML 페이지에서 스토리보드 애니메이션을 선언하지 않더라도 고려 사항입니다.

적용 대상

추가 정보