HitTestFilterBehavior Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica il comportamento restituito di un hit test in un metodo di callback del filtro hit test.
public enum class HitTestFilterBehaviorpublic enum HitTestFilterBehaviortype HitTestFilterBehavior = Public Enum HitTestFilterBehavior- Ereditarietà
Campi
| Nome | Valore | Descrizione |
|---|---|---|
| ContinueSkipSelfAndChildren | 0 | Non eseguire il hit test sull'oggetto corrente Visual o sui relativi discendenti. |
| ContinueSkipChildren | 2 | Eseguire un hit test sull'oggetto corrente Visual, ma non sui relativi discendenti. |
| ContinueSkipSelf | 4 | Non eseguire l'hit test sull'oggetto corrente Visual, ma eseguire il hit test sui discendenti. |
| Continue | 6 | Hit test contro l'oggetto corrente Visual e i relativi discendenti. |
| Stop | 8 | Arrestare l'hit testing nell'oggetto corrente Visual. |
Esempio
Nell'esempio seguente viene illustrato come restituire un HitTestFilterBehavior valore da un metodo di callback del filtro hit test. In questo caso, il filtro ignora le etichette e i relativi discendenti e verifica tutto il resto.
// 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
Commenti
Il valore restituito del callback del filtro di hit test è un HitTestFilterBehavioroggetto , che determina il tipo di azione da eseguire durante l'elaborazione dell'albero visivo per l'hit testing. Ad esempio, se il callback del filtro hit test restituisce il valore ContinueSkipSelfAndChildren, è possibile rimuovere l'oggetto visivo corrente e i relativi discendenti dalla valutazione dei risultati dell'hit test.
Note
L'eliminazione della struttura ad albero visuale degli oggetti riduce la quantità di elaborazione necessaria durante il passaggio di valutazione dei risultati dell'hit test.
Eliminazione di una struttura ad albero visuale
