HitTestFilterBehavior 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ヒット テスト フィルター コールバック メソッドでのヒット テストの戻り動作を指定します。
public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior =
Public Enum HitTestFilterBehavior
- 継承
フィールド
| 名前 | 値 | 説明 |
|---|---|---|
| ContinueSkipSelfAndChildren | 0 | 現在の Visual またはその子孫に対してテストをヒットしないでください。 |
| ContinueSkipChildren | 2 | 現在の Visualに対してヒット テストを実行しますが、その子孫に対してはヒット テストを実行しません。 |
| ContinueSkipSelf | 4 | 現在の Visualに対してテストをヒットせず、その子孫に対してヒット テストを実行します。 |
| Continue | 6 | 現在の 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値を返す場合は、ヒット テスト結果の評価から現在のビジュアル オブジェクトとその子孫を削除できます。
Note
オブジェクトのビジュアル ツリーを排除すると、ヒット テスト結果の評価パス中に必要な処理量が減少します。
ビジュアル ツリーの簡略化