HitTestFilterBehavior 列挙型

定義

名前空間:

System.Windows.Media

アセンブリ:

PresentationCore.dll

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

public enum class HitTestFilterBehavior

public enum HitTestFilterBehavior

type HitTestFilterBehavior = 

Public Enum HitTestFilterBehavior

継承

Object

ValueType

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を返す場合、ヒット テスト結果の評価から現在のビジュアル オブジェクトとその子孫を削除できます。

注意

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

ビジュアル ツリーの簡略化