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 属性时应用的注意事项。

• 滚动区域的背景必须不透明，或者将发生滚动项目。

• 仅当 WPF 在软件中呈现时，该 VisualScrollableAreaClip 属性才会加速滚动。 例如，当应用程序在远程桌面上运行或在虚拟机中本地运行时，会出现这种情况。

• 在硬件中呈现时，滚动行为保持不变。 若要防止滚动行为的差异，应保留 VisualScrollableAreaClip 为硬件和软件启用的属性。

• 旋转和倾斜转换禁用加速滚动。 缩放转换和滚动区域上方的水平或垂直转换正常工作，并且不会禁用滚动加速。

• 更改可滚动区域的子树或触发部分通过动画重新绘制的行为按预期方式进行，但失去重绘区域的加速滚动的好处。 在发生滚动的同一帧中使滚动区域失效的任何动画都消除了此优化的好处。

• 矩形 VisualScrollableAreaClip 向内对齐到像素。 因此，滚动矩形的贴靠大小始终小于或等于设置的大小。

• 偏移量向下对齐。 这意味着上一个贴靠偏移量和当前贴靠偏移量的差始终是一个整数的像素数。

• 命中测试最多可以关闭一个像素。

• 布局舍入应打开，因为它可确保可滚动区域和边界窗口工作区的边缘贴靠到像素边界，从而导致正确的对齐方式。

• 滚动加速不适用于分层窗口。 这意味着 AllowTransparency == true、window.windowstyle == none 等的窗口。

• 在全屏呈现期间不会发生滚动加速。

• 当窗口跨越两个监视器时，滚动加速不起作用。

• 滚动加速在滚动元素的父链中存在中间呈现目标时不起作用。 以下列表显示了其中一些中间呈现目标。

  • 剪辑

  • 效果

  • DrawingBrushes

  • VisualBrushes

  • OpacityMasks

  • 不透明度

• 每个帧只能发生一个加速滚动。 可以有多个加速滚动区域，但其中只有一个可以在帧期间执行加速滚动。 滚动的区域不确定。

• 滚动加速支持滚动区域上方的内容， (z 顺序) ，该内容未随其余内容一起滚动。 系统计算所有必要的脏区域并完成加速滚动，但它通过线路发送多个额外的位图，以将意外滚动部分移回屏幕上的正确位置。