HitTestFilterBehavior Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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 visuelle