Visual.HitTestCore Método

Definição

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina se um valor de ponto ou geometria está dentro dos limites do objeto visual.

Sobrecargas

Nome	Description
HitTestCore(GeometryHitTestParameters)	Determina se um valor de geometria está dentro dos limites do objeto visual.
HitTestCore(PointHitTestParameters)	Determina se um valor de coordenada de ponto está dentro dos limites do objeto visual.

HitTestCore(GeometryHitTestParameters)

Determina se um valor de geometria 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.GeometryHitTestResult

Protected Overridable Function HitTestCore (hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResult

Parâmetros

hitTestParameters: GeometryHitTestParameters

Um GeometryHitTestParameters objeto que especifica o Geometry teste a ser atingido.

Retornos

GeometryHitTestResult

Um GeometryHitTestResult que representa o resultado do teste de ocorrência.

Exemplos

O exemplo a seguir mostra como substituir o HitTestCore(GeometryHitTestParameters) método. Um motivo pelo qual talvez você queira substituir esse método é fornecer funcionalidade adicional durante o processo de teste de clique.

// 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

Comentários

Você pode substituir o suporte de teste de clique padrão para um objeto visual substituindo o HitTestCore método. Isso significa que, quando você invoca o método HitTest, sua implementação substituída de HitTestCore é chamada. Seu método substituído é chamado quando um teste de ocorrência se enquadra no retângulo delimitador do objeto visual, mesmo que a coordenada fique fora da geometria do objeto visual.

Aplica-se a

HitTestCore(PointHitTestParameters)

Determina se um valor de coordenada de ponto 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.HitTestResult

Protected Overridable Function HitTestCore (hitTestParameters As PointHitTestParameters) As HitTestResult

Parâmetros

hitTestParameters: PointHitTestParameters

Um PointHitTestParameters objeto que especifica o Point teste a ser atingido.

Retornos

HitTestResult

Um HitTestResult que representa o Visual que é retornado de um teste de ocorrência.

Exemplos

O exemplo a seguir mostra como substituir o HitTestCore(PointHitTestParameters) método. Um motivo pelo qual talvez você queira substituir esse método é fornecer funcionalidade adicional durante o processo de teste de clique.

// 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

Comentários

Você pode substituir o suporte de teste de ocorrência padrão em objetos visuais substituindo o HitTestCore método. Isso significa que, quando você invoca o método HitTest, sua implementação substituída de HitTestCore é chamada. Seu método substituído é chamado quando um teste de ocorrência se enquadra no retângulo delimitador do objeto visual, mesmo que a coordenada fique fora da geometria do objeto visual.

Aplica-se a

Comentários

Esta página foi útil?