GeometryHitTestParameters Classe

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Object

HitTestParameters

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).

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)