Visual.HitTestCore Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.GeometryHitTestResultProtected Overridable Function HitTestCore (hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResultParámetros
- hitTestParameters
- GeometryHitTestParameters
Objeto GeometryHitTestParameters que especifica el objeto Geometry en el que se ejecuta la prueba de posicionamiento.
Devoluciones
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.
Se aplica a
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.HitTestResultProtected Overridable Function HitTestCore (hitTestParameters As PointHitTestParameters) As HitTestResultParámetros
- hitTestParameters
- PointHitTestParameters
Objeto PointHitTestParameters que especifica el objeto Point en el que se ejecuta la prueba de posicionamiento.
Devoluciones
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.