HitTestFilterBehavior HitTestFilterBehavior HitTestFilterBehavior HitTestFilterBehavior Enum

정의

적중 횟수 테스트 필터 콜백 메서드에서 적중 횟수 테스트의 반환 동작을 지정합니다.Specifies the return behavior of a hit test in a hit test filter callback method.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
상속
HitTestFilterBehaviorHitTestFilterBehaviorHitTestFilterBehaviorHitTestFilterBehavior

필드

Continue Continue Continue Continue 6

현재 Visual 및 하위 항목에 대한 적중 횟수 테스트를 수행합니다.Hit test against the current Visual and its descendants.

ContinueSkipChildren ContinueSkipChildren ContinueSkipChildren ContinueSkipChildren 2

현재 Visual에 대한 적중 횟수 테스트를 수행하지만 하위 항목에 대한 적중 횟수 테스트를 수행하지 않습니다.Hit test against the current Visual, but not its descendants.

ContinueSkipSelf ContinueSkipSelf ContinueSkipSelf ContinueSkipSelf 4

현재 Visual에 대한 적중 횟수 테스트를 수행하지 않지만 하위 항목에 대한 적중 횟수 테스트를 수행합니다.Do not hit test against the current Visual, but hit test against its descendants.

ContinueSkipSelfAndChildren ContinueSkipSelfAndChildren ContinueSkipSelfAndChildren ContinueSkipSelfAndChildren 0

현재 Visual 또는 하위 항목에 대한 적중 횟수 테스트를 수행하지 않습니다.Do not hit test against the current Visual or its descendants.

Stop Stop Stop Stop 8

현재 Visual에서 적중 횟수 테스트를 중지합니다.Stop hit testing at the current Visual.

예제

다음 예제에서는 반환 하는 방법을 보여 줍니다는 HitTestFilterBehavior 적중 횟수 테스트 필터 콜백 메서드에서 값입니다.The following example shows how to return a HitTestFilterBehavior value from a hit test filter callback method. 이 경우 필터 레이블 및 해당 하위 항목을 건너뛰고 나머지 적중 테스트 합니다.In this case, the filter skips labels and their descendants and hit tests everything else.

// 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, 적중 테스트에 대 한 시각적 트리를 처리 하는 경우 어떤 유형의 동작을 가져와야 하는 것이 결정 합니다.The return value of the hit test filter callback is a HitTestFilterBehavior, which determines what type of action should be taken when processing the visual tree for hit testing. 예를 들어 적중 테스트 필터 콜백에서 값 ContinueSkipSelfAndChildren을 반환 하는 경우 적중 테스트 결과 계산에서 현재 시각적 개체 및 해당 하위 항목을 제거할 수 있습니다.For example, if your hit test filter callback returns the value ContinueSkipSelfAndChildren, you can remove the current visual object and its descendants from the hit test results evaluation.

참고

개체의 시각적 트리를 잘라내면는 필요한 적중 횟수 테스트 결과 계산 패스 동안 처리 양이 감소 합니다.Pruning the visual tree of objects decreases the amount of processing that is required during the hit test results evaluation pass.

적중된 테스트 필터를 사용 하 여 시각적 트리 정리Pruning a visual tree using a hit test filter
시각적 트리 정리Pruning a visual tree

적용 대상