Visual.HitTestCore Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Determina se um valor de ponto ou geometria está dentro dos limites do objeto visual.
Sobrecargas
| Name | Description |
|---|---|
| HitTestCore(GeometryHitTestParameters) |
Determina se um valor geométrico está dentro dos limites do objeto visual. |
| HitTestCore(PointHitTestParameters) |
Determina se o valor de uma coordenada pontual está dentro dos limites do objeto visual. |
HitTestCore(GeometryHitTestParameters)
Determina se um valor geométrico está dentro dos limites do 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
Um GeometryHitTestParameters objeto que especifica o Geometry teste de acertar contra.
Devoluções
A GeometryHitTestResult que representa o resultado do teste de sucesso.
Exemplos
O exemplo seguinte mostra como sobrepor o HitTestCore(GeometryHitTestParameters) método. Uma das razões para querer ultrapassar este método é fornecer funcionalidades adicionais durante o processo de teste de acertos.
// 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
Observações
Podes sobrescrever o suporte padrão para testes de acertos para um objeto visual, sobrescrevendo o HitTestCore método. Isso significa que, quando invocas o método HitTest, a tua implementação substituta de HitTestCore é chamada. O seu método sobreposto é chamado quando um teste de acerto cai dentro do retângulo delimitador do objeto visual, mesmo que a coordenada esteja fora da geometria do objeto visual.
Aplica-se a
HitTestCore(PointHitTestParameters)
Determina se o valor de uma coordenada pontual está dentro dos limites do 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
Um PointHitTestParameters objeto que especifica o Point teste de acertar contra.
Devoluções
A HitTestResult que representa o Visual que é devolvido de um teste de acerto.
Exemplos
O exemplo seguinte mostra como sobrepor o HitTestCore(PointHitTestParameters) método. Uma das razões para querer ultrapassar este método é fornecer funcionalidades adicionais durante o processo de teste de acertos.
// 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
Observações
Podes sobrescrever o suporte padrão para testes de acertos em objetos visuais ao sobrescrever o HitTestCore método. Isso significa que, quando invocas o método HitTest, a tua implementação substituta de HitTestCore é chamada. O seu método sobreposto é chamado quando um teste de acerto cai dentro do retângulo delimitador do objeto visual, mesmo que a coordenada esteja fora da geometria do objeto visual.
