HitTestFilterBehavior 列挙型

定義

ヒット テスト フィルター コールバック メソッドでのヒット テストの戻り動作を指定します。

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
継承
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

オブジェクトのビジュアル ツリーを排除すると、ヒット テスト結果の評価パス中に必要な処理量が減少します。

ヒット テスト フィルターを使用したビジュアル ツリーの排除 ヒット テスト フィルター
ビジュアル ツリーの簡略化

適用対象