ContainerVisual.HitTest Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Retourne l’objet visuel le plus haut d’un test de positionnement.

Surcharges

HitTest(Point)	Retourne l’objet visuel supérieur d’un test de positionnement en spécifiant un Point.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Exécute un test de positionnement sur ContainerVisual à l’aide des objets HitTestFilterCallback et HitTestResultCallback.

HitTest(Point)

Retourne l’objet visuel supérieur d’un test de positionnement en spécifiant un Point.

public:
 System::Windows::Media::HitTestResult ^ HitTest(System::Windows::Point point);

public System.Windows.Media.HitTestResult HitTest (System.Windows.Point point);

member this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult

Public Function HitTest (point As Point) As HitTestResult

Paramètres

point

Point

Valeur de point pour laquelle effectuer le test de positionnement.

Retours

HitTestResult

Résultat du test de positionnement de l’élément visuel retourné en tant que type HitTestResult.

Exemples

L’exemple suivant montre comment récupérer la HitTestResult valeur de retour à partir de la HitTest méthode .

// 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

Remarques

La VisualHit propriété de la valeur de retour représente l’objet Visual qui a été atteint.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Exécute un test de positionnement sur ContainerVisual à l’aide des objets HitTestFilterCallback et 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);

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)

Paramètres

filterCallback

HitTestFilterCallback

Délégué qui vous permet d’ignorer les parties de l’arborescence d’éléments visuels que vous ne souhaitez pas traiter dans vos résultats de test de positionnement.

resultCallback

HitTestResultCallback

Délégué qui sert à contrôler le retour d’informations sur les tests de positionnement.

hitTestParameters

HitTestParameters

Définit le jeu de paramètres pour un test de positionnement.

Remarques

Le filterCallback paramètre peut être null, auquel cas il est ignoré. Si filterCallback n’est pas null, il est appelé avant resultCallback.