HitTestFilterBehavior Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das Rückgabeverhalten eines Treffertests in einer Treffertest-Rückrufmethode an.
public enum class HitTestFilterBehaviorpublic enum HitTestFilterBehaviortype HitTestFilterBehavior = Public Enum HitTestFilterBehavior- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| ContinueSkipSelfAndChildren | 0 | Führen Sie keinen Treffertest mit dem aktuellen Visual oder dessen Nachfolger aus. |
| ContinueSkipChildren | 2 | Treffertest für den aktuellen Visual, aber nicht für seine Nachfolger. |
| ContinueSkipSelf | 4 | Drücken Sie nicht den Treffertest gegen den aktuellen Visual, sondern treffertest gegen die untergeordneten Elemente. |
| Continue | 6 | Treffertest für den aktuellen Visual und dessen Nachfolger. |
| Stop | 8 | Beenden Sie Treffertests am aktuellen Visual. |
Beispiele
Das folgende Beispiel zeigt, wie ein HitTestFilterBehavior Wert aus einer Rückrufmethode für Treffertestfilter zurückgegeben wird. In diesem Fall überspringt der Filter Bezeichnungen und deren Nachfolger und überprüft alles andere.
// 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
Hinweise
Der Rückgabewert des Treffertestfilterrückrufs ist ein HitTestFilterBehavior, der bestimmt, welche Art von Aktion beim Verarbeiten der visuellen Struktur für Treffertests ausgeführt werden soll. Wenn ihr Treffertestfilterrückruf beispielsweise den Wert ContinueSkipSelfAndChildrenzurückgibt, können Sie das aktuelle visuelle Objekt und dessen Nachfolger aus der Auswertung der Treffertestergebnisse entfernen.
Note
Durch das Löschen der visuellen Struktur von Objekten wird die Verarbeitungsmenge verringert, die während des Auswertungsdurchlaufs der Treffertests erforderlich ist.
Reduzieren der Verzweigungen in einer visuellen Struktur
