HitTestFilterBehavior 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ヒット テスト フィルターのコールバック メソッドでヒット テストの戻り値の動作を指定します。
public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior =
Public Enum HitTestFilterBehavior
- 継承
フィールド
Continue | 6 | 現在の Visual およびその子孫に対してヒット テストを行います。 |
ContinueSkipChildren | 2 | 現在の Visual に対してヒット テストを行いますが、その子孫については行いません。 |
ContinueSkipSelf | 4 | 現在の Visual に対してはヒット テストを行いませんが、その子孫については行います。 |
ContinueSkipSelfAndChildren | 0 | 現在の Visual に対してもその子孫に対してもヒット テストを行いません。 |
Stop | 8 | 現在の Visual 対するヒット テストを停止します。 |
例
次の例は、ヒット テスト フィルター コールバック メソッドから値を返す HitTestFilterBehavior
方法を示しています。 この場合、フィルターはラベルとその子孫をスキップし、他のすべてをヒット テストします。
// Filter the hit test values for each object in the enumeration.
public HitTestFilterBehavior MyHitTestFilter(DependencyObject o)
{
// Test for the object value you want to filter.
if (o.GetType() == typeof(Label))
{
// Visual object and descendants are NOT part of hit test results enumeration.
return HitTestFilterBehavior.ContinueSkipSelfAndChildren;
}
else
{
// Visual object is part of hit test results enumeration.
return HitTestFilterBehavior.Continue;
}
}
' Filter the hit test values for each object in the enumeration.
Public Function MyHitTestFilter(ByVal o As DependencyObject) As HitTestFilterBehavior
' Test for the object value you want to filter.
If o.GetType() Is GetType(Label) Then
' Visual object and descendants are NOT part of hit test results enumeration.
Return HitTestFilterBehavior.ContinueSkipSelfAndChildren
Else
' Visual object is part of hit test results enumeration.
Return HitTestFilterBehavior.Continue
End If
End Function
注釈
ヒット テスト フィルター コールバックの戻り値は です HitTestFilterBehavior
。これは、ヒット テスト用にビジュアル ツリーを処理するときに実行する必要があるアクションの種類を決定します。 たとえば、ヒット テスト フィルター コールバックが 値 ContinueSkipSelfAndChildren
を返す場合、ヒット テスト結果の評価から現在のビジュアル オブジェクトとその子孫を削除できます。
注意
オブジェクトのビジュアル ツリーを排除すると、ヒット テスト結果の評価パス中に必要な処理量が減少します。
ビジュアル ツリーの簡略化
適用対象
.NET