Visual.VisualScrollableAreaClip 속성

정의

네임스페이스:

System.Windows.Media

어셈블리:

PresentationCore.dll

Visual의 스크롤할 수 있는 클리핑된 영역을 가져오거나 설정합니다.

public:  property Nullable<System::Windows::Rect> VisualScrollableAreaClip {  protected public:
Nullable<System::Windows::Rect> get(); protected:
 void set(Nullable<System::Windows::Rect> value); };

public System.Windows.Rect? VisualScrollableAreaClip { protected internal get; protected set; }

member this.VisualScrollableAreaClip : Nullable<System.Windows.Rect> with get, set

Public Property VisualScrollableAreaClip As Nullable(Of Rect)

속성 값

Nullable<Rect>

스크롤할 수 있는 클리핑 영역을 나타내는 Rect이거나 클리핑 영역이 할당되지 않은 경우 null입니다.

설명

소프트웨어에서 VisualScrollableAreaClip 렌더링할 때 가속 스크롤을 사용하도록 속성을 설정합니다. 원격 데스크톱을 통해 실행하거나 가상 머신에서 실행하는 것과 같은 원격 렌더링 시나리오에서 유용합니다. 자식이 스크롤되는 부모 요소에서 이 속성을 설정합니다. 렌더링이 하드웨어 가속 시 VisualScrollableAreaClip 속성 설정에는 영향을 주지 않습니다.

이 속성은 VisualScrollableAreaClip 특정 고급 시나리오를 사용하도록 설정합니다. 다음 목록에서는 속성을 사용할 VisualScrollableAreaClip 때 적용되는 주의 사항을 보여 줍니다.

• 스크롤된 영역의 배경은 불투명해야 합니다. 그렇지 않으면 스크롤 아티팩트가 발생합니다.

• 이 속성은 VisualScrollableAreaClip WPF가 소프트웨어에서 렌더링되는 경우에만 스크롤을 가속화합니다. 예를 들어,이 경우 애플리케이션은 원격 데스크톱을 통해 실행 하거나 가상 컴퓨터에서 로컬로 실행할 때 발생 합니다.

• 하드웨어에서 렌더링할 때 스크롤 동작은 변경되지 않습니다. 스크롤 동작의 차이를 방지하려면 하드웨어와 소프트웨어 모두에 VisualScrollableAreaClip 대해 속성을 사용하도록 설정해야 합니다.

• 회전 및 기울이기 변환은 가속 스크롤을 사용하지 않도록 설정합니다. 스크롤된 영역 위의 배율 변환 및 가로 또는 세로 변환이 올바르게 작동하며 스크롤 가속을 사용하지 않도록 설정하지 않습니다.

• 애니메이션을 통해 다시 그리기 위해 하위 트리를 변경하거나 스크롤 가능 영역의 일부를 트리거하는 것은 예상대로 동작하지만 다시 그려지는 영역에 대한 가속 스크롤의 이점을 잃게 됩니다. 스크롤이 발생하는 동일한 프레임 동안 스크롤된 영역을 무효화하는 애니메이션은 이 최적화의 이점을 제거합니다.

• 사각형이 VisualScrollableAreaClip 안쪽에서 픽셀로 맞춰지도록 합니다. 따라서 스크롤 사각형의 스냅된 크기는 항상 설정한 크기보다 작거나 같습니다.

• 오프셋이 아래쪽으로 맞춰지게 됩니다. 즉, 이전에 스냅된 오프셋과 현재 스냅된 오프셋의 차이는 항상 정수 픽셀 수입니다.

• 적중 테스트는 최대 픽셀까지 해제할 수 있습니다.

• 스크롤 가능한 영역과 경계 창 클라이언트 영역의 가장자리가 픽셀 경계에 맞춰져 올바른 맞춤이 가능하므로 레이아웃 반올림을 설정해야 합니다.

• 스크롤 가속은 계층화된 창에서 작동하지 않습니다. 즉, AllowTransparency == true, window.windowstyle == none 등이 있는 창을 의미합니다.

• 전체 창 렌더링 중에는 스크롤 가속이 발생하지 않습니다.

• 창이 두 개의 모니터를 가로지르면 스크롤 가속이 작동하지 않습니다.

• 스크롤된 요소의 부모 체인에 중간 렌더링 대상이 있는 경우에는 스크롤 가속이 작동하지 않습니다. 다음 목록에서는 이러한 중간 렌더링 대상 중 일부를 보여 줍니다.

  • Clips

  • 효과

  • DrawingBrushes

  • VisualBrushes

  • OpacityMasks

  • 불투명도

• 프레임당 하나의 가속 스크롤만 발생할 수 있습니다. 여러 개의 가속 스크롤 영역이 있을 수 있지만 그 중 하나만 프레임 동안 가속 스크롤을 수행할 수 있습니다. 스크롤되는 영역이 확정되지 않았습니다.

• 스크롤 가속은 나머지 콘텐츠와 함께 스크롤되지 않는 스크롤 영역 위의 콘텐츠(z 순서)를 지원합니다. 시스템은 필요한 모든 더티 영역을 계산하고 가속 스크롤을 완료하지만, 의도치 않게 스크롤된 부분을 화면에서 올바른 위치로 다시 이동하기 위해 와이어를 통해 몇 가지 추가 비트맵을 보냅니다.