Cómo realizar una prueba de impacto utilizando la geometría como parámetro

En este ejemplo se muestra cómo realizar una prueba de posicionamiento en un objeto visual mediante un Geometry como parámetro de prueba de posicionamiento.

Ejemplo

En el ejemplo siguiente se muestra cómo realizar una prueba de impacto mediante GeometryHitTestParameters para el método HitTest. El Point valor que se pasa al OnMouseDown método se usa para crear un Geometry objeto con el fin de expandir el intervalo de la prueba de impacto.

// Respond to the mouse button down event by setting up a hit test results callback.
private void OnMouseDown(object sender, MouseButtonEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // Expand the hit test area by creating a geometry centered on the hit test point.
    EllipseGeometry expandedHitTestArea = new EllipseGeometry(pt, 10.0, 10.0);

    // Clear the contents of the list used for hit test results.
    hitResultsList.Clear();

    // Set up a callback to receive the hit test result enumeration.
    VisualTreeHelper.HitTest(myControl, null,
        new HitTestResultCallback(MyHitTestResultCallback),
        new GeometryHitTestParameters(expandedHitTestArea));

    // Perform actions on the hit test results list.
    if (hitResultsList.Count > 0)
    {
        ProcessHitTestResultsList();
    }
}

' Respond to the mouse button down event by setting up a hit test results callback.
Private Overloads Sub OnMouseDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinate of the mouse position.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Expand the hit test area by creating a geometry centered on the hit test point.
    Dim expandedHitTestArea As New EllipseGeometry(pt, 10.0, 10.0)

    ' Clear the contents of the list used for hit test results.
    hitResultsList.Clear()

    ' Set up a callback to receive the hit test result enumeration.
    VisualTreeHelper.HitTest(myControl, Nothing, New HitTestResultCallback(AddressOf MyHitTestResultCallback), New GeometryHitTestParameters(expandedHitTestArea))

    ' Perform actions on the hit test results list.
    If hitResultsList.Count > 0 Then
        ProcessHitTestResultsList()
    End If
End Sub

La propiedad IntersectionDetail de GeometryHitTestResult proporciona información sobre los resultados de una prueba de impacto utilizando Geometry como parámetro de prueba. En la ilustración siguiente se muestra la relación entre la geometría de la prueba de posicionamiento (el círculo azul) y el contenido representado del objeto visual de destino (el cuadrado rojo).

En el ejemplo siguiente se muestra cómo implementar una devolución de llamada de prueba de impacto cuando Geometry se usa como parámetro de prueba de impacto. El result parámetro se convierte en un GeometryHitTestResult para recuperar el valor de la IntersectionDetail propiedad . El valor de la propiedad permite determinar si el parámetro Geometry de la prueba de impacto está totalmente o parcialmente contenido dentro del contenido renderizado del objetivo de la prueba de impacto. En este caso, el código de ejemplo solo agrega resultados de pruebas de colisión a la lista para los objetos visuales que están totalmente contenidos dentro del límite de destino.

// Return the result of the hit test to the callback.
public HitTestResultBehavior MyHitTestResultCallback(HitTestResult result)
{
    // Retrieve the results of the hit test.
    IntersectionDetail intersectionDetail = ((GeometryHitTestResult)result).IntersectionDetail;

    switch (intersectionDetail)
    {
        case IntersectionDetail.FullyContains:

            // Add the hit test result to the list that will be processed after the enumeration.
            hitResultsList.Add(result.VisualHit);

            return HitTestResultBehavior.Continue;

        case IntersectionDetail.Intersects:

            // Set the behavior to return visuals at all z-order levels.
            return HitTestResultBehavior.Continue;

        case IntersectionDetail.FullyInside:

            // Set the behavior to return visuals at all z-order levels.
            return HitTestResultBehavior.Continue;

        default:
            return HitTestResultBehavior.Stop;
    }
}

' Return the result of the hit test to the callback.
Public Function MyHitTestResultCallback(ByVal result As HitTestResult) As HitTestResultBehavior
    ' Retrieve the results of the hit test.
    Dim intersectionDetail As IntersectionDetail = (CType(result, GeometryHitTestResult)).IntersectionDetail

    Select Case intersectionDetail
        Case IntersectionDetail.FullyContains

            ' Add the hit test result to the list that will be processed after the enumeration.
            hitResultsList.Add(result.VisualHit)

            Return HitTestResultBehavior.Continue

        Case IntersectionDetail.Intersects

            ' Set the behavior to return visuals at all z-order levels.
            Return HitTestResultBehavior.Continue

        Case IntersectionDetail.FullyInside

            ' Set the behavior to return visuals at all z-order levels.
            Return HitTestResultBehavior.Continue

        Case Else
            Return HitTestResultBehavior.Stop
    End Select
End Function

Nota:

No se debe invocar el callback cuando el detalle de intersección es HitTestResult.

Consulte también

• Prueba de contacto en la capa visual
• Geometría de prueba de impacto en un elemento visual