HitTestFilterBehavior 열거형

정의

네임스페이스:

System.Windows.Media

어셈블리:

PresentationCore.dll

적중 테스트 필터 콜백 메서드에서 적중 테스트의 반환 동작을 지정합니다.

public enum class HitTestFilterBehavior

public enum HitTestFilterBehavior

type HitTestFilterBehavior = 

Public Enum HitTestFilterBehavior

상속

Object

ValueType

Enum

HitTestFilterBehavior

필드

Name	값	Description
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반환하는 경우 적중 테스트 결과 평가에서 현재 시각적 개체와 해당 하위 항목을 제거할 수 있습니다.

메모

개체의 시각적 트리를 정리하면 적중 테스트 결과 평가 통과 중에 필요한 처리 양이 줄어듭니다.

를
시각적 트리 정리