HitTestFilterBehavior Enumerazione

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Specifica il comportamento di restituzione di un hit test in un metodo di callback del filtro hit test.

public enum class HitTestFilterBehavior

public enum HitTestFilterBehavior

type HitTestFilterBehavior = 

Public Enum HitTestFilterBehavior

Ereditarietà

Object

ValueType

Enum

HitTestFilterBehavior

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