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 等的視窗。

• 在全視窗轉譯期間不會發生捲動加速。

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

• 捲動加速無法在捲動專案的父鏈中存在中繼轉譯目標時運作。 下列清單顯示其中一些中繼轉譯目標。

  • 剪輯

  • 效果

  • DrawingBrushes

  • VisualBrushes

  • 不透明度遮罩

  • 不透明度

• 每個畫面只能有一個加速捲動。 可以有多個加速捲動區域，但其中只有一個可以在框架期間執行加速捲動。 要捲動的區域不確定。

• 捲動加速支援在捲動區域上方的內容， (以 z 順序) ，但未隨其餘內容捲動。 系統會計算所有必要的已變更區域並完成加速捲動，但它會透過網路傳送數個額外的點陣圖，以將意外捲動的部分移回畫面上的正確位置。