ContainerVisual.HitTest Método

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Devuelve el objeto visual de nivel superior de una prueba de posicionamiento.

Sobrecargas

HitTest(Point)	Devuelve el objeto visual de nivel superior de una prueba de posicionamiento al especificar un objeto Point.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicia una prueba de posicionamiento en ContainerVisual mediante los objetos HitTestFilterCallback y HitTestResultCallback.

HitTest(Point)

Devuelve el objeto visual de nivel superior de una prueba de posicionamiento al especificar un objeto Point.

public:
 System::Windows::Media::HitTestResult ^ HitTest(System::Windows::Point point);

public System.Windows.Media.HitTestResult HitTest (System.Windows.Point point);

member this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult

Public Function HitTest (point As Point) As HitTestResult

Parámetros

point

Point

El valor de punto de prueba de posicionamiento.

Devoluciones

HitTestResult

El resultado de la prueba de posicionamiento del objeto visual devuelto como un tipo HitTestResult.

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar el HitTestResult valor devuelto del HitTest método .

// 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.
    Point pt = e.GetPosition((UIElement)sender);

    // Initiate the hit test on the ContainerVisual's visual tree.
    HitTestResult result = _containerVisual.HitTest(pt);

    // Perform the action on the hit visual.
    if (result.VisualHit != null)
    {
        ProcessHitVisual((Visual)result.VisualHit);
    }
}

' 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 System.Windows.Input.MouseButtonEventArgs)
    ' Retrieve the coordinates of the mouse button event.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Initiate the hit test on the ContainerVisual's visual tree.
    Dim result As HitTestResult = _containerVisual.HitTest(pt)

    ' Perform the action on the hit visual.
    If result.VisualHit IsNot Nothing Then
        ProcessHitVisual(CType(result.VisualHit, Visual))
    End If
End Sub

Comentarios

La VisualHit propiedad del valor devuelto representa el Visual objeto al que se ha alcanzado.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia una prueba de posicionamiento en ContainerVisual mediante los objetos HitTestFilterCallback y HitTestResultCallback.

public:
 void HitTest(System::Windows::Media::HitTestFilterCallback ^ filterCallback, System::Windows::Media::HitTestResultCallback ^ resultCallback, System::Windows::Media::HitTestParameters ^ hitTestParameters);

public void HitTest (System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.HitTestParameters hitTestParameters);

member this.HitTest : System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit

Public Sub HitTest (filterCallback As HitTestFilterCallback, resultCallback As HitTestResultCallback, hitTestParameters As HitTestParameters)

Parámetros

filterCallback

HitTestFilterCallback

Delegado que permite omitir las partes del árbol visual que no se desean procesar en los resultados de la prueba de posicionamiento.

resultCallback

HitTestResultCallback

Delegado que se usa para controlar la devolución de información de la prueba de posicionamiento.

hitTestParameters

HitTestParameters

Define el conjunto de parámetros para una prueba de posicionamiento.

Comentarios

El filterCallback parámetro puede ser null, en cuyo caso se omite. Si filterCallback no nulles , se invoca antes resultCallbackde .