Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Property

정의

Visual의 스크롤할 수 있는 클리핑된 영역을 가져오거나 설정합니다.Gets or sets a clipped scrollable area for the Visual.

public:  property Nullable<System::Windows::Rect> VisualScrollableAreaClip {  protected public:
Nullable<System::Windows::Rect> get(); protected:
 void set(Nullable<System::Windows::Rect> value); };
public Nullable<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)

속성 값

스크롤할 수 있는 클리핑 영역을 나타내는 Rect이거나 클리핑 영역이 할당되지 않은 경우 null입니다.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

설명

설정 된 VisualScrollableAreaClip 소프트웨어에서 렌더링할 때 스크롤 속성을 가속화 합니다.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. 원격 데스크톱을 통해 또는 가상 컴퓨터에서 실행 하는 등의 원격 렌더링 시나리오에서 유용 합니다.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. 부모 요소의 자식을 스크롤할 수는이 속성을 설정 합니다.Set this property on the parent element whose children will be scrolled. 설정 된 VisualScrollableAreaClip 렌더링은 하드웨어 가속 속성은 효과가 없습니다.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

VisualScrollableAreaClip 속성을 사용 하면 특정 고급 시나리오입니다.The VisualScrollableAreaClip property enables specific, advanced scenarios. 다음 목록은 사용 하는 경우 적용 되는 주의 VisualScrollableAreaClip 속성입니다.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • 스크롤 영역의 배경을 불투명 이거나 아티팩트 스크롤 발생 합니다.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • VisualScrollableAreaClip 속성은 WPF는 소프트웨어에서 렌더링할 때에 스크롤을 가속화 합니다.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. 예를 들어,이 경우 응용 프로그램은 원격 데스크톱을 통해 실행 하거나 가상 컴퓨터에서 로컬로 실행할 때 발생 합니다.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • 하드웨어에서 렌더링 하는 경우에 스크롤 동작을 변경 되지 않습니다.The scrolling behavior is unchanged when rendering in hardware. 스크롤 동작의 차이 방지 하려면 보관 해야 합니다 VisualScrollableAreaClip 하드웨어 및 소프트웨어를 모두 사용 하도록 설정 하는 속성입니다.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • 회전 및 기울이기 변환 가속 스크롤을 비활성화합니다.Rotate and skew transforms disable accelerated scrolling. Scale 변환과 스크롤된 영역 위에 가로 또는 세로 번역 제대로 작동 하 고 스크롤 가속을 해제 하지 않습니다.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • 하위 트리를 변경 하거나 애니메이션을 통해 다시 그리기를 스크롤할 수 있는 영역의 일부를 트리거하면 예상 대로 작동 하지만 다시 영역에 대 한 가속 스크롤의 이점을 잃게 됩니다.Changing the subtree or triggering parts of the scrollable area to redraw via animation behave as expected, but lose the benefit of accelerated scrolling for the redrawn area. 동일한 프레임 중 스크롤된 영역을 무효화 하는 애니메이션 스크롤 하는이 최적화의 장점을 제거 발생 합니다.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • VisualScrollableAreaClip 사각형 안쪽 픽셀으로 맞춥니다.The VisualScrollableAreaClip rectangle snaps inward to pixels. 따라서 스크롤 영역의 기본 크기는 항상 설정한 크기 보다 작거나 합니다.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • 오프셋을 아래로 맞춥니다.Offsets snap downward. 이 이전의 차이 기본 오프셋을 현재 기본 오프셋은 픽셀 정수 항상 의미 합니다.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • 적중된 테스트는 픽셀까지 여 해제할 수 있습니다.Hit tests can be off by up to a pixel.

  • 레이아웃 반올림 켜야, 스크롤 가능한 영역 및 경계 창의 클라이언트 영역 가장자리 모눈으로 픽셀 경계를 올바르게 정렬 하는 것이 있기 때문에 있습니다.Layout rounding should be turned on, because it ensures that the edges of scrollable areas and the boundary window client area are snapped to pixel boundaries, resulting in correct alignment.

  • 창 겹침된 가속 스크롤이 작동 하지 않습니다.Scrolling acceleration does not work on layered windows. 즉, windows는 AllowTransparency의 = = true window.windowstyle = = none, 및 등입니다.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • 가속 스크롤 전체 창 렌더링 하는 동안 발생 하지 않습니다.Scrolling acceleration does not occur during full-window rendering.

  • 가속 스크롤 창의 두 모니터를 포괄 하는 경우 작동 하지 않습니다.Scrolling acceleration does not work when the window straddles two monitors.

  • 가속 스크롤이 있는 스크롤 요소의 부모 체인에서 중간 렌더링 대상 작동 하지 않습니다.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. 다음 목록은 몇 가지 중간 렌더링 대상입니다.The following list shows some of these intermediate render targets.

    • 클립Clips

    • 효과Effects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • OpacityOpacity

  • 프레임 마다 하나의 가속된 스크롤 발생할 수 있습니다.Only one accelerated scroll can happen per frame. 여러 가속된 스크롤 영역에 있을 수 있지만 그 중 하나만 프레임 중 가속된 된 스크롤을 수행할 수 있습니다.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. 어떤 영역 스크롤되는 확정적이 지 않습니다.Which area is scrolled is indeterminate.

  • 가속 스크롤 스크롤 영역 (z 좌표) 콘텐츠의 rest를 사용 하 여 스크롤되지 않는 위에 콘텐츠를 지원 합니다.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. 시스템 필요한 모든 변경 영역을 계산 하 고 가속화 된 scroll을 완료 하지만 스크롤된 실수로 부분으로 이동 네트워크를 통해 몇 가지 추가 비트맵 화면에서 올바른 위치로 다시 보냅니다.The system calculates all necessary dirty regions and completes the accelerated scroll, but it sends several additional bitmaps over the wire to move the unintentionally scrolled portion back to its correct position on screen.

적용 대상