HitTestFilterBehavior Énumération

Définition

Espace de noms:
System.Windows.Media
Assembly:
PresentationCore.dll

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
Object
ValueType
Enum
HitTestFilterBehavior

Champs

Nom Valeur Description
ContinueSkipSelfAndChildren 0

Ne pas atteindre le test par rapport au courant Visual ou à ses descendants.
ContinueSkipChildren 2

Test de positionnement contre le courant Visual, mais pas ses descendants.
ContinueSkipSelf 4

N’effectuez pas de test de positionnement par rapport au test de positionnement actuel Visual, mais test de positionnement contre ses descendants.
Continue 6

Test de positionnement sur le courant Visual et ses descendants.
Stop 8

Arrêtez les tests de positionnement à l’heure actuelle Visual.

Exemples

L’exemple suivant montre comment retourner une HitTestFilterBehavior valeur à partir d’une méthode de rappel de filtre de test de positionnement. Dans ce cas, le filtre ignore les étiquettes et leurs descendants et teste 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 de positionnement est un HitTestFilterBehavior, qui détermine le type d’action à effectuer lors du traitement de l’arborescence visuelle pour les tests de positionnement. Par exemple, si votre rappel de filtre de test de positionnement retourne la valeur ContinueSkipSelfAndChildren, vous pouvez supprimer l’objet visuel actuel et ses descendants de l’évaluation des résultats du test de positionnement.

Note

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 de positionnement.

Taille d’une arborescence visuelle à l’aide d’un filtre de test d’accès
Élagage d’une arborescence visuelle

S’applique à