Visual.HitTestCore Método

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Determina si un punto geométrico está dentro de los límites del objeto visual.

Sobrecargas

HitTestCore(GeometryHitTestParameters)	Determina si un valor geométrico está dentro de los límites del objeto visual.
HitTestCore(PointHitTestParameters)	Determina si un valor de coordenada de punto está dentro de los límites del objeto visual.

HitTestCore(GeometryHitTestParameters)

Determina si un valor geométrico está dentro de los límites del objeto visual.

protected:
 virtual System::Windows::Media::GeometryHitTestResult ^ HitTestCore(System::Windows::Media::GeometryHitTestParameters ^ hitTestParameters);

protected virtual System.Windows.Media.GeometryHitTestResult HitTestCore (System.Windows.Media.GeometryHitTestParameters hitTestParameters);

abstract member HitTestCore : System.Windows.Media.GeometryHitTestParameters -> System.Windows.Media.GeometryHitTestResult
override this.HitTestCore : System.Windows.Media.GeometryHitTestParameters -> System.Windows.Media.GeometryHitTestResult

Protected Overridable Function HitTestCore (hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResult

Parámetros

hitTestParameters

GeometryHitTestParameters

Objeto GeometryHitTestParameters que especifica el objeto Geometry en el que se ejecuta la prueba de posicionamiento.

Devoluciones

GeometryHitTestResult

Objeto GeometryHitTestResult que representa el resultado de la prueba de posicionamiento.

Ejemplos

En el ejemplo siguiente se muestra cómo se invalida el método HitTestCore(GeometryHitTestParameters). Una razón por la que es posible que quiera invalidar este método es proporcionar funcionalidad adicional durante el proceso de prueba de posicionamiento.

// Override default hit test support in visual object.
protected override GeometryHitTestResult HitTestCore(GeometryHitTestParameters hitTestParameters)
{
    IntersectionDetail intersectionDetail = IntersectionDetail.NotCalculated;

    // Perform custom actions during the hit test processing.

    return new GeometryHitTestResult(this, intersectionDetail);
}

' Override default hit test support in visual object.
Protected Overrides Overloads Function HitTestCore(ByVal hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResult
    Dim intersectionDetail As IntersectionDetail = IntersectionDetail.NotCalculated

    ' Perform custom actions during the hit test processing.

    Return New GeometryHitTestResult(Me, intersectionDetail)
End Function

Comentarios

Puede invalidar la compatibilidad de pruebas de posicionamiento predeterminadas para un objeto visual reemplazando el HitTestCore método . Esto significa que cuando se invoca el HitTest método , se llama a la implementación invalidada de HitTestCore . Se llama al método invalidado cuando una prueba de posicionamiento se encuentra dentro del rectángulo delimitador del objeto visual, incluso si la coordenada está fuera de la geometría del objeto visual.

HitTestCore(PointHitTestParameters)

Determina si un valor de coordenada de punto está dentro de los límites del objeto visual.

protected:
 virtual System::Windows::Media::HitTestResult ^ HitTestCore(System::Windows::Media::PointHitTestParameters ^ hitTestParameters);

protected virtual System.Windows.Media.HitTestResult HitTestCore (System.Windows.Media.PointHitTestParameters hitTestParameters);

abstract member HitTestCore : System.Windows.Media.PointHitTestParameters -> System.Windows.Media.HitTestResult
override this.HitTestCore : System.Windows.Media.PointHitTestParameters -> System.Windows.Media.HitTestResult

Protected Overridable Function HitTestCore (hitTestParameters As PointHitTestParameters) As HitTestResult

Parámetros

hitTestParameters

PointHitTestParameters

Objeto PointHitTestParameters que especifica el objeto Point en el que se ejecuta la prueba de posicionamiento.

Devoluciones

HitTestResult

Objeto HitTestResult, que representa el objeto Visual devuelto desde la prueba de posicionamiento.

Ejemplos

En el ejemplo siguiente se muestra cómo se invalida el método HitTestCore(PointHitTestParameters). Una razón por la que es posible que quiera invalidar este método es proporcionar funcionalidad adicional durante el proceso de prueba de posicionamiento.

// Override default hit test support in visual object.
protected override HitTestResult HitTestCore(PointHitTestParameters hitTestParameters)
{
    Point pt = hitTestParameters.HitPoint;

    // Perform custom actions during the hit test processing,
    // which may include verifying that the point actually
    // falls within the rendered content of the visual.

    // Return hit on bounding rectangle of visual object.
    return new PointHitTestResult(this, pt);
}

' Override default hit test support in visual object.
Protected Overrides Overloads Function HitTestCore(ByVal hitTestParameters As PointHitTestParameters) As HitTestResult
    Dim pt As Point = hitTestParameters.HitPoint

    ' Perform custom actions during the hit test processing,
    ' which may include verifying that the point actually
    ' falls within the rendered content of the visual.

    ' Return hit on bounding rectangle of visual object.
    Return New PointHitTestResult(Me, pt)
End Function

Comentarios

Puede invalidar la compatibilidad predeterminada de pruebas de posicionamiento en objetos visuales reemplazando el HitTestCore método . Esto significa que cuando se invoca el HitTest método , se llama a la implementación invalidada de HitTestCore . Se llama al método invalidado cuando una prueba de posicionamiento se encuentra dentro del rectángulo delimitador del objeto visual, incluso si la coordenada está fuera de la geometría del objeto visual.