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 di restituzione 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
| Continue | 6 | Esegue l'hit test sulla classe Visual corrente e sui relativi discendenti. |
| ContinueSkipChildren | 2 | Esegue l'hit test sull'oggetto Visual corrente ma non sui relativi discendenti. |
| ContinueSkipSelf | 4 | Non esegue l'hit test sull'oggetto Visual corrente, bensì sui relativi discendenti. |
| ContinueSkipSelfAndChildren | 0 | Non esegue l'hit test sull'oggetto Visual corrente né sui relativi discendenti. |
| Stop | 8 | Arresta l'esecuzione dell'hit test sulla classe Visual corrente. |
Esempio
Nell'esempio seguente viene illustrato come restituire un HitTestFilterBehavior valore da un metodo di callback del filtro di hit test. In questo caso, il filtro ignora le etichette e i discendenti e colpisce 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 il hit testing. Ad esempio, se il callback del filtro di hit test restituisce il valore ContinueSkipSelfAndChildren, è possibile rimuovere l'oggetto visivo corrente e i relativi discendenti dalla valutazione dei risultati del test di hit test.
Nota
L'eliminazione dell'albero visivo degli oggetti riduce la quantità di elaborazione necessaria durante il passaggio di valutazione dei risultati del test di hit.
Eliminazione di una struttura ad albero visuale
