Visual.VisualScrollableAreaClip プロパティ

定義

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 ピクセル単位でスナップされます。 そのため、スクロールする四角形のスナップされたサイズは、設定したサイズ以下になります。

  • スナップを下にオフセットします。 これは、前のスナップされたオフセットと現在のスナップされたオフセットの差が常に整数のピクセル数であることを意味します。

  • ヒットテストは、最大で1ピクセルまでオフにできます。

  • レイアウトの丸め処理は、スクロール可能な領域と境界ウィンドウのクライアント領域の端がピクセル境界にスナップされることを保証し、正しい配置になるため、有効にする必要があります。

  • スクロールの加速は、レイヤードウィンドウでは機能しません。 これは、AllowTransparency = = true、system.windows.window.windowstyle = = none などのウィンドウを意味します。

  • スクロールの加速は、全ウィンドウのレンダリング中には発生しません。

  • ウィンドウが2つのモニターをまたがっしている場合、スクロールの加速は機能しません。

  • スクロールの加速は、スクロールした要素の親チェーンに中間レンダーターゲットが存在する場合には機能しません。 これらの中間レンダーターゲットの一部を次の一覧に示します。

    • Clips

    • 効果

    • 図面ブラシ

    • VisualBrushes

    • OpacityMasks

    • Opacity

  • 1フレームにつき1つのアクセラレータスクロールだけが発生します。 加速スクロール領域は複数存在する場合がありますが、そのうちの1つだけが、フレーム中に高速スクロールを実行できます。 スクロールされる領域は不確定です。

  • スクロールの加速は、コンテンツの残りの部分でスクロールされないスクロール領域 (z オーダー) 上のコンテンツをサポートします。 システムは必要なすべてのダーティ領域を計算し、高速スクロールを完了しますが、誤ってスクロールされた部分を画面上の正しい位置に移動するために、ネットワーク上でいくつかの追加のビットマップを送信します。

適用対象