GeometryHitTestParameters Classe

Definição

Especifica a Geometry como o parâmetro a ser usado para testar acertos numa á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 seguinte mostra como configurar um teste de acerto usando GeometryHitTestParameters o HitTest método. O Point valor que é passado ao OnMouseDown método é usado para criar um Geometry objeto de modo a expandir o alcance do teste de acerto.

// 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ção sobre os resultados de um teste de acerto que utiliza a Geometry como parâmetro de teste de acerto. A ilustração seguinte mostra a relação entre a geometria do teste de acerto (o círculo azul) e o objeto-alvo (o quadrado vermelho).

Diagrama de InterseçãoDetalhe usado em testes de acertos Interseção entre a geometria do teste de acerto e o objeto-alvo

Observações

Com a GeometryHitTestParameters classe, podes usar um Geometry valor para testes de acerto, para determinar se algum objeto visual intersecta com o Geometry valor.

Também podes carregar em testar com um Point valor criando um PointHitTestParameters objeto.

Note

O teste de acertos do Windows Presentation Foundation (WPF) só considera a área preenchida de uma geometria durante um teste de acerto. Se criares um ponto Geometry, o teste de acerto não cruzaria nada porque um ponto não tem área.

Construtores

Name Description
GeometryHitTestParameters(Geometry)

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

Propriedades

Name Description
HitGeometry

Obtém-se o Geometry que define a geometria do teste de acerto neste GeometryHitTestParameters caso.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a