Compartilhar via


GeometryHitTestParameters Classe

Definição

Especifica um Geometry como o parâmetro a ser usado para teste de clique de uma árvore 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
Herança
GeometryHitTestParameters

Exemplos

O exemplo a seguir mostra como configurar um teste de clique usando GeometryHitTestParameters para o HitTest método . O Point valor passado para o OnMouseDown método é usado para criar um Geometry objeto para expandir o intervalo do teste de clique.

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

A IntersectionDetail propriedade de GeometryHitTestResult fornece informações sobre os resultados de um teste de clique que usa um Geometry como um parâmetro de teste de clique. A ilustração a seguir mostra a relação entre a geometria do teste de clique (o círculo azul) e o objeto de destino (o quadrado vermelho).

Diagrama de IntersectionDetail usado no teste de clique
Interseção entre geometria de teste de clique e objeto de destino

Comentários

Com a GeometryHitTestParameters classe , você pode usar um Geometry valor para teste de clique para determinar se algum objeto visual se cruza com o Geometry valor .

Você também pode fazer o teste de clique com um Point valor criando um PointHitTestParameters objeto .

Observação

Windows Presentation Foundation (WPF) considera apenas a área preenchida de uma geometria durante um teste de clique. Se você criar um ponto Geometry, o teste de clique não interseccionará nada porque um ponto não tem área.

Construtores

GeometryHitTestParameters(Geometry)

Inicializa uma nova instância da classe GeometryHitTestParameters, usando o Geometry especificado.

Propriedades

HitGeometry

Obtém o Geometry que define a geometria de teste de clique para esta instância de GeometryHitTestParameters.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a