HitTestFilterBehavior Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica el comportamiento de devolución de una prueba de posicionamiento en un método de devolución de llamada de filtro de prueba de posicionamiento.
public enum class HitTestFilterBehaviorpublic enum HitTestFilterBehaviortype HitTestFilterBehavior = Public Enum HitTestFilterBehavior- Herencia
Campos
| Continue | 6 | Realizar pruebas de posicionamiento con el elemento Visual actual y con sus descendientes. |
| ContinueSkipChildren | 2 | Realizar pruebas de posicionamiento con el elemento Visual actual, pero no con sus descendientes. |
| ContinueSkipSelf | 4 | No realizar pruebas de posicionamiento con el elemento Visual actual, pero sí con sus descendientes. |
| ContinueSkipSelfAndChildren | 0 | No realizar pruebas de posicionamiento con el elemento Visual actual ni con sus descendientes. |
| Stop | 8 | Detener las pruebas de posicionamiento actuales en el elemento Visual. |
Ejemplos
En el ejemplo siguiente se muestra cómo devolver un HitTestFilterBehavior valor de un método de devolución de llamada de filtro de prueba de posicionamiento. En este caso, el filtro omite las etiquetas y sus descendientes y prueba de posicionamiento todo lo demás.
// 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
Comentarios
El valor devuelto de la devolución de llamada del filtro de prueba de posicionamiento es , HitTestFilterBehaviorque determina qué tipo de acción se debe realizar al procesar el árbol visual para las pruebas de posicionamiento. Por ejemplo, si la devolución de llamada del filtro de pruebas de posicionamiento devuelve el valor ContinueSkipSelfAndChildren, puede quitar el objeto visual actual y sus descendientes de la evaluación de resultados de la prueba de posicionamiento.
Nota:
La eliminación del árbol visual de objetos reduce la cantidad de procesamiento que se requiere durante el paso de evaluación de los resultados de la prueba de posicionamiento.
Eliminar un árbol visual
