HitTestFilterBehavior Enum
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u het retourgedrag van een hittest in een callback-methode voor hittestfilters op.
public enum class HitTestFilterBehaviorpublic enum HitTestFilterBehaviortype HitTestFilterBehavior = Public Enum HitTestFilterBehavior- Overname
Velden
| Name | Waarde | Description |
|---|---|---|
| ContinueSkipSelfAndChildren | 0 | Druk niet op de toets tegen de huidige Visual of de onderliggende. |
| ContinueSkipChildren | 2 | Treffertest tegen de huidige Visual, maar niet de afstammelingen. |
| ContinueSkipSelf | 4 | Raak de test niet tegen de huidige Visual, maar druk op de afstammelingen. |
| Continue | 6 | Treffertest tegen de huidige Visual en de bijbehorende nakomelingen. |
| Stop | 8 | Stop met testen op het huidige Visualmoment. |
Voorbeelden
In het volgende voorbeeld ziet u hoe u een HitTestFilterBehavior waarde retourneert van een callbackmethode voor het hittestfilter. In dit geval slaat het filter labels en hun afstammelingen over en worden alle andere tests bereikt.
// 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
Opmerkingen
De retourwaarde van de callback van het treffertestfilter is een HitTestFilterBehavior, waarmee wordt bepaald welk type actie moet worden ondernomen bij het verwerken van de visualstructuur voor het testen van treffers. Als de callback van het hittestfilter bijvoorbeeld de waarde ContinueSkipSelfAndChildrenretourneert, kunt u het huidige visuele object en de onderliggende elementen van de evaluatie van de resultaten van de hittest verwijderen.
Note
Door de visuele boomstructuur van objecten te verwijderen, wordt de hoeveelheid verwerking die nodig is tijdens de evaluatie van de geslaagde testresultaten verlaagd.
Een visuele boom snoeien
