HitTestFilterBehavior Enum

Definition

Anger returbeteendet för ett träfftest i en återanropsmetod för träfftestfilter.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Arv
HitTestFilterBehavior

Fält

Name Värde Description
ContinueSkipSelfAndChildren 0

Kör inte testet mot den aktuella Visual eller dess underordnade.

ContinueSkipChildren 2

Tryck på test mot aktuella Visual, men inte dess underordnade.

ContinueSkipSelf 4

Kör inte testet mot det aktuella Visual, men tryck på testet mot dess underordnade.

Continue 6

Tryck på test mot strömmen Visual och dess underordnade.

Stop 8

Stoppa träfftestningen vid den aktuella Visual.

Exempel

I följande exempel visas hur du returnerar ett HitTestFilterBehavior värde från en återanropsmetod för träfftestfilter. I det här fallet hoppar filtret över etiketter och deras underordnade och träffar tester allt annat.

// 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

Kommentarer

Returvärdet för återanropet för träfftestfiltret är en HitTestFilterBehavior, som avgör vilken typ av åtgärd som ska vidtas när du bearbetar det visuella trädet för träfftestning. Om motanropet för träfftestfiltret till exempel returnerar värdet ContinueSkipSelfAndChildrenkan du ta bort det aktuella visuella objektet och dess underordnade objekt från utvärderingen av träfftestresultatet.

Note

Om du rensar objektens visuella träd minskar mängden bearbetning som krävs under utvärderingsversionen av träfftestresultatet.

Rensa ett visuellt träd med hjälp av ett träfftestfilter
Beskära ett visuellt träd

Gäller för