HitTestResultCallback Delegado

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Representa una devolución de llamada que se usa para personalizar la prueba de aciertos. WPF invoca a HitTestResultCallback para informar de las intersecciones de la prueba de aciertos al usuario.

public delegate System::Windows::Media::HitTestResultBehavior HitTestResultCallback(HitTestResult ^ result);

public delegate System.Windows.Media.HitTestResultBehavior HitTestResultCallback(HitTestResult result);

type HitTestResultCallback = delegate of HitTestResult -> HitTestResultBehavior

Public Delegate Function HitTestResultCallback(result As HitTestResult) As HitTestResultBehavior 

Parámetros

result

HitTestResult

Valor HitTestResult que representa un objeto visual que se devuelve de una prueba de aciertos.

Valor devuelto

HitTestResultBehavior

HitTestFilterBehavior que representa la acción resultante de la prueba de aciertos.

Ejemplos

En el ejemplo siguiente se muestra cómo invocar HitTest mediante un HitTestResultCallback valor . También se define el método de devolución de llamada de la prueba de posicionamiento correspondiente.

// Capture the mouse event and hit test the coordinate point value against
// the child visual objects.
void MyVisualHost_MouseLeftButtonUp(object sender, System.Windows.Input.MouseButtonEventArgs e)
{
    // Retrieve the coordinates of the mouse button event.
    System.Windows.Point pt = e.GetPosition((UIElement)sender);

    // Initiate the hit test by setting up a hit test result callback method.
    VisualTreeHelper.HitTest(this, null, new HitTestResultCallback(myCallback), new PointHitTestParameters(pt));
}

// If a child visual object is hit, toggle its opacity to visually indicate a hit.
public HitTestResultBehavior myCallback(HitTestResult result)
{
    if (result.VisualHit.GetType() == typeof(DrawingVisual))
    {
        if (((DrawingVisual)result.VisualHit).Opacity == 1.0)
        {
            ((DrawingVisual)result.VisualHit).Opacity = 0.4;
        }
        else
        {
            ((DrawingVisual)result.VisualHit).Opacity = 1.0;
        }
    }

    // Stop the hit test enumeration of objects in the visual tree.
    return HitTestResultBehavior.Stop;
}

' Capture the mouse event and hit test the coordinate point value against
' the child visual objects.
Private Sub MyVisualHost_MouseLeftButtonUp(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinates of the mouse button event.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Initiate the hit test by setting up a hit test result callback method.
    VisualTreeHelper.HitTest(Me, Nothing, New HitTestResultCallback(AddressOf myCallback), New PointHitTestParameters(pt))
End Sub

' If a child visual object is hit, toggle its opacity to visually indicate a hit.
Public Function myCallback(ByVal result As HitTestResult) As HitTestResultBehavior
    If result.VisualHit.GetType() Is GetType(DrawingVisual) Then
        If (CType(result.VisualHit, DrawingVisual)).Opacity = 1.0 Then
            CType(result.VisualHit, DrawingVisual).Opacity = 0.4
        Else
            CType(result.VisualHit, DrawingVisual).Opacity = 1.0
        End If
    End If

    ' Stop the hit test enumeration of objects in the visual tree.
    Return HitTestResultBehavior.Stop
End Function

Comentarios

El método de devolución de llamada de prueba 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 espera que la devolución de llamada devuelva un HitTestResultBehavior valor que determine si se debe seguir iterando por el árbol visual para cualquier otro objeto visual.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.