GeometryHitTestParameters Clase

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Especifica Geometry como parámetro que se va a usar para las pruebas de aciertos de un árbol visual.

public ref class GeometryHitTestParameters : System::Windows::Media::HitTestParameters

public class GeometryHitTestParameters : System.Windows.Media.HitTestParameters

type GeometryHitTestParameters = class
    inherit HitTestParameters

Public Class GeometryHitTestParameters
Inherits HitTestParameters

Herencia

Object

HitTestParameters

GeometryHitTestParameters

Ejemplos

El ejemplo siguiente muestra cómo configurar la prueba de posicionamiento mediante GeometryHitTestParameters para el método HitTest. El valor Point que se pasa al método OnMouseDown se usa para crear un objeto Geometry para expandir el rango de la prueba de posicionamiento.

// 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 posicionamiento que usa Geometry como parámetro. 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 objeto de destino (el cuadrado rojo).

Intersección entre la geometría de la prueba de posicionamiento y el objeto de destino

Comentarios

Con la GeometryHitTestParameters clase , puede usar un Geometry valor para las pruebas de posicionamiento, para determinar si cualquier objeto visual se interseca con el Geometry valor .

También puede realizar la prueba de posicionamiento con un Point valor mediante la creación de un PointHitTestParameters objeto .

Nota

Windows Presentation Foundation (WPF) las pruebas de posicionamiento solo consideran el área rellenada de una geometría durante una prueba de posicionamiento. Si crea un punto Geometry, la prueba de posicionamiento no intersectaría nada porque un punto no tiene ningún área.

Constructores

GeometryHitTestParameters(Geometry)

Inicializa una nueva instancia de la clase GeometryHitTestParameters, mediante la clase Geometry especificada.

Propiedades

HitGeometry

Obtiene la Geometry que define la geometría de la prueba de posicionamiento para esta instancia GeometryHitTestParameters.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)