HitTestFilterBehavior Énumération

Définition

Spécifie le comportement de retour d’un test de positionnement dans une méthode de rappel de filtre de test de positionnement.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Héritage
HitTestFilterBehavior

Champs

Continue 6

Effectuer un test de positionnement sur le Visual actuel et sur ses descendants.

ContinueSkipChildren 2

Effectuer un test de positionnement sur le Visual actuel, mais pas sur ses descendants.

ContinueSkipSelf 4

Ne pas effectuer de test de positionnement sur le Visual actuel, mais en effectuer un sur ses descendants.

ContinueSkipSelfAndChildren 0

Ne pas effectuer de test de positionnement sur le Visual actuel ou sur ses descendants.

Stop 8

Arrêter le test de positionnement au Visualactuel.

Exemples

L’exemple suivant montre comment retourner une valeur à partir d’une HitTestFilterBehavior méthode de rappel de filtre de test d’accès. Dans ce cas, le filtre ignore les étiquettes et leurs descendants et frappe tout le reste.

// 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

Remarques

La valeur de retour du rappel de filtre de test d’accès est un HitTestFilterBehavior, qui détermine le type d’action à effectuer lors du traitement de l’arborescence visuelle pour les tests d’accès. Par exemple, si votre rappel de filtre de test d’accès retourne la valeur ContinueSkipSelfAndChildren, vous pouvez supprimer l’objet visuel actuel et ses descendants de l’évaluation des résultats des tests d’accès.

Notes

La taille de l’arborescence visuelle des objets diminue la quantité de traitement requise pendant la réussite de l’évaluation des résultats des tests d’accès.

Élagage d’une arborescence d’éléments visuels à l’aide d’un filtre de test de positionnement
Élagage d’une arborescence visuelle

S’applique à