ContainerVisual.HitTest Método
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.
Devolver o objeto visual mais alto de um teste de acerto.
Sobrecargas
| Name | Descrição |
|---|---|
| HitTest(Point) |
Devolve o objeto visual mais topo de um teste de acerto especificando um Point. |
| HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) |
Inicia um teste de acerto no ContainerVisual usando os HitTestFilterCallback objetos e HitTestResultCallback . |
HitTest(Point)
Devolve o objeto visual mais topo de um teste de acerto especificando um Point.
public:
System::Windows::Media::HitTestResult ^ HitTest(System::Windows::Point point);
public System.Windows.Media.HitTestResult HitTest(System.Windows.Point point);
override this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult
member this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult
Public Function HitTest (point As Point) As HitTestResult
Parâmetros
- point
- Point
O valor em pontos para o teste de acerto.
Devoluções
O resultado do teste de acerto do visual devolveu como um HitTestResult tipo.
Exemplos
O exemplo seguinte mostra como recuperar o HitTestResult valor de retorno do HitTest método.
// Capture the mouse event and hit test the coordinate point value against
// the child visual objects.
void MyVisualHost_MouseLeftButtonUp(object sender, System.Windows.Input.MouseButtonEventArgs e)
{
// Retrieve the coordinates of the mouse button event.
Point pt = e.GetPosition((UIElement)sender);
// Initiate the hit test on the ContainerVisual's visual tree.
HitTestResult result = _containerVisual.HitTest(pt);
// Perform the action on the hit visual.
if (result.VisualHit != null)
{
ProcessHitVisual((Visual)result.VisualHit);
}
}
' Capture the mouse event and hit test the coordinate point value against
' the child visual objects.
Private Sub MyVisualHost_MouseLeftButtonUp(ByVal sender As Object, ByVal e As System.Windows.Input.MouseButtonEventArgs)
' Retrieve the coordinates of the mouse button event.
Dim pt As Point = e.GetPosition(CType(sender, UIElement))
' Initiate the hit test on the ContainerVisual's visual tree.
Dim result As HitTestResult = _containerVisual.HitTest(pt)
' Perform the action on the hit visual.
If result.VisualHit IsNot Nothing Then
ProcessHitVisual(CType(result.VisualHit, Visual))
End If
End Sub
Observações
A VisualHit propriedade do valor de retorno representa o Visual objeto atingido.
Aplica-se a
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)
Inicia um teste de acerto no ContainerVisual usando os HitTestFilterCallback objetos e HitTestResultCallback .
public:
void HitTest(System::Windows::Media::HitTestFilterCallback ^ filterCallback, System::Windows::Media::HitTestResultCallback ^ resultCallback, System::Windows::Media::HitTestParameters ^ hitTestParameters);
public void HitTest(System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.HitTestParameters hitTestParameters);
override this.HitTest : System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit
member this.HitTest : System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit
Public Sub HitTest (filterCallback As HitTestFilterCallback, resultCallback As HitTestResultCallback, hitTestParameters As HitTestParameters)
Parâmetros
- filterCallback
- HitTestFilterCallback
O delegado que lhe permite ignorar partes da árvore visual que não está interessado em processar nos resultados do seu teste de acerto.
- resultCallback
- HitTestResultCallback
O delegado que é usado para controlar o retorno da informação do teste de acerto.
- hitTestParameters
- HitTestParameters
Define o conjunto de parâmetros para um teste de acerto.
Observações
O filterCallback parâmetro pode ser nulo, caso em que é ignorado. Se filterCallback não nullfor , é invocado antes resultCallbackde .