ContainerVisual.HitTest Método

Definição

Retorna o primeiro objeto visual de um teste de clique.

Sobrecargas

HitTest(Point)

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

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no ContainerVisual usando os objetos HitTestFilterCallback e HitTestResultCallback.

HitTest(Point)

Retorna o primeiro objeto visual de um teste de clique 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 de ponto a ter o teste de clique feito.

Retornos

HitTestResult

O resultado do teste de clique do objeto visual retornado como um tipo HitTestResult.

Exemplos

O exemplo a seguir mostra como recuperar o HitTestResult valor retornado 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

Comentários

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

Aplica-se a

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no ContainerVisual usando os objetos HitTestFilterCallback 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 permite que você ignore as partes da árvore visual que você não está interessado em processar nos seus resultados de teste de clique.

resultCallback
HitTestResultCallback

O delegado usado para controlar o retorno de informações de teste de clique.

hitTestParameters
HitTestParameters

Define o conjunto de parâmetros para um teste de clique.

Comentários

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

Aplica-se a