HitTestFilterBehavior Enumeración

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

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 HitTestFilterBehavior

public enum HitTestFilterBehavior

type HitTestFilterBehavior = 

Public Enum HitTestFilterBehavior

Herencia

Object

ValueType

Enum

HitTestFilterBehavior

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