ContainerVisual.HitTest Método

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

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.

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.