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