Linguagem

ContainerVisual.HitTest Método

Definição

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 .

Aplica-se a