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 A 代表可滾動的裁剪區域，或null若沒有指派裁剪區域。

備註

設定 VisualScrollableAreaClip 該屬性在軟體渲染時啟用加速捲動。 這在遠端渲染場景中非常有用，例如在遠端桌面上執行或在虛擬機中執行。 在將被捲動的子元素的父元素上設定此屬性。 設定該 VisualScrollableAreaClip 屬性在渲染時沒有影響，尤其是硬體加速。

該 VisualScrollableAreaClip 特性能實現特定且進階的情境。 以下列出使用該 VisualScrollableAreaClip 物業時適用的注意事項。

• 捲動區域的背景必須是不透明的，否則會出現捲動的瑕疵。

• 這個 VisualScrollableAreaClip 特性只有在軟體中渲染 WPF 時才會加速捲動。 例如，當應用程式運行於遠端桌面或本地虛擬機中時，就會出現這種情況。

• 在硬體渲染時，捲動行為保持不變。 為了避免捲動行為上的差異，你應該同時啟用這個 VisualScrollableAreaClip 屬性，無論是硬體還是軟體。

• 旋轉和傾斜變形會關閉加速捲動。 縮放變換以及滾動區域上方的水平或垂直平移都能正常運作，且不會關閉捲動加速。

• 改變子樹或觸發可捲動區域的部分透過動畫重新繪製，行為符合預期，但失去了重繪區域加速捲動的好處。 任何在同一幀內使滾動區域失效的動畫，都消除了這種優化的好處。

• VisualScrollableAreaClip矩形會向內吸附成像素。 因此，捲動矩形的吸附大小總是小於或等於你設定的大小。

• 偏移量會向下彈跳。 這表示先前吸附偏移量與目前吸附偏移量的差值總是整數個像素。

• 命中測試的誤差可能高達一個像素。

• 應開啟版面四捨五入，因為它確保可捲動區域的邊緣與邊界視窗用戶端區域的邊緣被吸附到像素邊界，從而產生正確的對齊。

• 捲動加速在分層視窗上無法運作。 這表示視窗中 AllowTransparency == 真、window.windowstyle == 無，依此類推。

• 在全視窗渲染時不會發生捲動加速。

• 當視窗跨越兩個螢幕時，捲動加速無法運作。

• 捲動加速在被捲動元素母鏈中存在中間渲染目標時無法運作。 以下列表展示了部分中間渲染目標。

  • 片段

  • 影響

  • 畫筆

  • 視覺筆刷

  • 不透明面罩

  • 不透明度

• 每幀只能發生一次加速捲動。 可以有多個加速捲軸區域，但只有一個區域能在一幀內執行加速捲軸。 是哪個區域被捲動了，這點無法確定。

• 捲動加速支援滾動區域以上（z順序）且未與其他內容一同捲動的內容。 系統會計算所有必要的髒區域並完成加速滾動，但會透過線路傳送多個額外的點陣圖，將無意中捲動的部分移回螢幕正確位置。