VisualTreeHelper.HitTest Método

Definição

Retorna o objeto Visual mais alto de um teste de clique.

Sobrecargas

HitTest(Visual, Point)

Retorna o primeiro objeto Visual de um teste de clique especificando um Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Inicia um teste de clique no Visual3D especificado, com métodos HitTestFilterCallback e HitTestResultCallback definidos pelo chamador.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no Visual especificado, com métodos HitTestFilterCallback e HitTestResultCallback definidos pelo chamador.

Comentários

Os métodos sobrecarregados que tomam HitTestResultCallback e HitTestFilterCallback como parâmetros fornecem funcionalidade adicional durante o teste de ocorrência:

  • Permita que você participe do controle da passagem da árvore visual durante o teste de clique.

  • Permita que você recupere todos os visuais sob o ponto ou geometria, não apenas o mais alto.

HitTest(Visual, Point)

Retorna o primeiro objeto Visual de um teste de clique especificando um Point.

public:
 static System::Windows::Media::HitTestResult ^ HitTest(System::Windows::Media::Visual ^ reference, System::Windows::Point point);
public static System.Windows.Media.HitTestResult HitTest (System.Windows.Media.Visual reference, System.Windows.Point point);
static member HitTest : System.Windows.Media.Visual * System.Windows.Point -> System.Windows.Media.HitTestResult
Public Shared Function HitTest (reference As Visual, point As Point) As HitTestResult

Parâmetros

reference
Visual

O Visual ao qual será aplicado o teste de clique.

point
Point

O valor do ponto no qual será feito o teste de clique.

Retornos

HitTestResult

O resultado do teste de clique do Visual, retornado como um tipo HitTestResult.

Exemplos

O exemplo a seguir mostra como usar o HitTest método para testar os objetos em um Canvas.

// Respond to the left mouse button down event by initiating the hit test.
private void OnMouseLeftButtonDown(object sender, MouseButtonEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // Perform the hit test against a given portion of the visual object tree.
    HitTestResult result = VisualTreeHelper.HitTest(myCanvas, pt);

    if (result != null)
    {
        // Perform action on hit visual object.
    }
}
' Respond to the left mouse button down event by initiating the hit test.
Private Overloads Sub OnMouseLeftButtonDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinate of the mouse position.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Perform the hit test against a given portion of the visual object tree.
    Dim result As HitTestResult = VisualTreeHelper.HitTest(myCanvas, pt)

    If result IsNot Nothing Then
        ' Perform action on hit visual object.
    End If
End Sub

Comentários

A VisualHit propriedade do valor retornado representa o Visual objeto que foi atingido.

Observação

É possível que um teste de ocorrência iniciado em uma árvore visual 2D retorne RayHitTestResult, que é um objeto de resultado de teste de clique 3D. O teste de clique que começa em uma árvore visual 2D se estende perfeitamente para qualquer árvore visual 3D definida.

Confira também

Aplica-se a

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Inicia um teste de clique no Visual3D especificado, com métodos HitTestFilterCallback e HitTestResultCallback definidos pelo chamador.

public:
 static void HitTest(System::Windows::Media::Media3D::Visual3D ^ reference, System::Windows::Media::HitTestFilterCallback ^ filterCallback, System::Windows::Media::HitTestResultCallback ^ resultCallback, System::Windows::Media::Media3D::HitTestParameters3D ^ hitTestParameters);
public static void HitTest (System.Windows.Media.Media3D.Visual3D reference, System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.Media3D.HitTestParameters3D hitTestParameters);
static member HitTest : System.Windows.Media.Media3D.Visual3D * System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.Media3D.HitTestParameters3D -> unit
Public Shared Sub HitTest (reference As Visual3D, filterCallback As HitTestFilterCallback, resultCallback As HitTestResultCallback, hitTestParameters As HitTestParameters3D)

Parâmetros

reference
Visual3D

O Visual3D ao qual será aplicado o teste de clique.

filterCallback
HitTestFilterCallback

O método que representa o valor do retorno de chamada do filtro do teste de clique.

resultCallback
HitTestResultCallback

O método que representa o valor do retorno de chamada do resultado do teste de clique.

hitTestParameters
HitTestParameters3D

O valor do parâmetro 3D com o qual o teste de clique será executado.

Comentários

O filterCallback parâmetro pode ser null, nesse caso, ignorado. Se filterCallback não nullfor, ele será invocado antes resultCallback. resultCallback não pode ser null.

Observação

É possível que um teste de ocorrência iniciado em uma árvore visual 2D retorne RayHitTestResult, que é um objeto de resultado de teste de clique 3D. O teste de clique que começa em uma árvore visual 2D se estende perfeitamente para qualquer árvore visual 3D definida.

Aplica-se a

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no Visual especificado, com métodos HitTestFilterCallback e HitTestResultCallback definidos pelo chamador.

public:
 static void HitTest(System::Windows::Media::Visual ^ reference, System::Windows::Media::HitTestFilterCallback ^ filterCallback, System::Windows::Media::HitTestResultCallback ^ resultCallback, System::Windows::Media::HitTestParameters ^ hitTestParameters);
public static void HitTest (System.Windows.Media.Visual reference, System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.HitTestParameters hitTestParameters);
static member HitTest : System.Windows.Media.Visual * System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit
Public Shared Sub HitTest (reference As Visual, filterCallback As HitTestFilterCallback, resultCallback As HitTestResultCallback, hitTestParameters As HitTestParameters)

Parâmetros

reference
Visual

O Visual ao qual será aplicado o teste de clique.

filterCallback
HitTestFilterCallback

O método que representa o valor do retorno de chamada do filtro do teste de clique.

resultCallback
HitTestResultCallback

O método que representa o valor do retorno de chamada do resultado do teste de clique.

hitTestParameters
HitTestParameters

O valor do parâmetro ao qual o teste de clique será comparado.

Exemplos

O exemplo a seguir mostra como usar o HitTest método para testar os objetos em um Canvas.

// Respond to the right mouse button down event by setting up a hit test results callback.
private void OnMouseRightButtonDown(object sender, MouseButtonEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // 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(myCanvas, null,
        new HitTestResultCallback(MyHitTestResult),
        new PointHitTestParameters(pt));

    // Perform actions on the hit test results list.
    if (hitResultsList.Count > 0)
    {
        Console.WriteLine("Number of Visuals Hit: " + hitResultsList.Count);
    }
}
' Respond to the right mouse button down event by setting up a hit test results callback.
Private Overloads Sub OnMouseRightButtonDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinate of the mouse position.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' 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(myCanvas, Nothing, New HitTestResultCallback(AddressOf MyHitTestResult), New PointHitTestParameters(pt))

    ' Perform actions on the hit test results list.
    If hitResultsList.Count > 0 Then
        Console.WriteLine("Number of Visuals Hit: " & hitResultsList.Count)
    End If
End Sub
// Return the result of the hit test to the callback.
public HitTestResultBehavior MyHitTestResult(HitTestResult result)
{
    // Add the hit test result to the list that will be processed after the enumeration.
    hitResultsList.Add(result.VisualHit);

    // Set the behavior to return visuals at all z-order levels.
    return HitTestResultBehavior.Continue;
}
' Return the result of the hit test to the callback.
Public Function MyHitTestResult(ByVal result As HitTestResult) As HitTestResultBehavior
    ' Add the hit test result to the list that will be processed after the enumeration.
    hitResultsList.Add(result.VisualHit)

    ' Set the behavior to return visuals at all z-order levels.
    Return HitTestResultBehavior.Continue
End Function

Comentários

O filterCallback parâmetro pode ser null, nesse caso, ele é ignorado. Se filterCallback não nullfor, ele será invocado antes resultCallback. resultCallback não pode ser null.

Observação

É possível que um teste de ocorrência iniciado em uma árvore visual 2D retorne RayHitTestResult, que é um objeto de resultado de teste de clique 3D. O teste de clique que começa em uma árvore visual 2D se estende perfeitamente para qualquer árvore visual 3D definida.

Confira também

Aplica-se a