HitTestResultBehavior 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í.
Determina si se va a continuar la enumeración de los objetos visuales restantes durante una prueba de posicionamiento.
public enum class HitTestResultBehavior
public enum HitTestResultBehavior
type HitTestResultBehavior =
Public Enum HitTestResultBehavior
- Herencia
Campos
| Nombre | Valor | Description |
|---|---|---|
| Stop | 0 | Detenga las pruebas de posicionamiento adicionales y vuelva de la devolución de llamada. |
| Continue | 1 | Continúe las pruebas de posicionamiento en el siguiente objeto visual de la jerarquía del árbol visual. |
Ejemplos
En el ejemplo siguiente se muestra cómo devolver un HitTestResultBehavior valor de un método de devolución de llamada de resultados de pruebas de posicionamiento.
// Return the result of the hit test to the callback.
public HitTestResultBehavior MyHitTestResult(HitTestResult result)
{
// Add the hit test result to the list that will be processed after the enumeration.
hitResultsList.Add(result.VisualHit);
// Set the behavior to return visuals at all z-order levels.
return HitTestResultBehavior.Continue;
}
' Return the result of the hit test to the callback.
Public Function MyHitTestResult(ByVal result As HitTestResult) As HitTestResultBehavior
' Add the hit test result to the list that will be processed after the enumeration.
hitResultsList.Add(result.VisualHit)
' Set the behavior to return visuals at all z-order levels.
Return HitTestResultBehavior.Continue
End Function
Comentarios
Un método de devolución de llamada de resultados de pruebas de posicionamiento define las acciones que se realizan cuando se identifica una prueba de posicionamiento en un objeto visual determinado del árbol visual. Después de realizar las acciones, se devuelve un HitTestResultBehavior valor que determina si se va a continuar la enumeración de cualquier otro objeto visual.
Puede enumerar todos los objetos visuales de un árbol visual cuya geometría contiene un valor de coordenada especificado. Al devolver Continue en el método de devolución de llamada de la prueba de posicionamiento, puede identificar todos los objetos visuales que se alcanzan, incluso aquellos que pueden estar parcialmente o totalmente ocultos por otros objetos visuales.