ContainerVisual.HitTest Méthode

Définition

Retourne l’objet visuel le plus haut d’un test de positionnement.Return top-most visual object of a hit test.

Surcharges

HitTest(Point)

Retourne l’objet visuel supérieur d’un test de positionnement en spécifiant un Point.Returns the top-most visual object of a hit test by specifying a Point.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Exécute un test de positionnement sur ContainerVisual à l’aide des objets HitTestFilterCallback et HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point)

Retourne l’objet visuel supérieur d’un test de positionnement en spécifiant un Point.Returns the top-most visual object of a hit test by specifying a 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
override 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.The point value to hit test.

Retours

HitTestResult

Résultat du test de positionnement de l’élément visuel retourné en tant que type HitTestResult.The hit test result of the visual returned as a HitTestResult type.

Exemples

L’exemple suivant montre comment récupérer la HitTestResult valeur de retour de la HitTest méthode.The following example shows how to retrieve the HitTestResult return value from the HitTest method.

// 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' Visual objet qui a été atteint.The VisualHit property of the return value represents the Visual object that was hit.

S’applique à

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Exécute un test de positionnement sur ContainerVisual à l’aide des objets HitTestFilterCallback et HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

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
override 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.The delegate that allows you to ignore parts of the visual tree that you are not interested in processing in your hit test results.

resultCallback
HitTestResultCallback

Délégué qui sert à contrôler le retour d’informations sur les tests de positionnement.The delegate that is used to control the return of hit test information.

hitTestParameters
HitTestParameters

Définit le jeu de paramètres pour un test de positionnement.Defines the set of parameters for a hit test.

Remarques

Le filterCallback paramètre peut avoir la valeur null, auquel cas il est ignoré.The filterCallback parameter can be null, in which case, it is ignored. Si filterCallback n’est pas null , il est appelé avant resultCallback .If filterCallback is not null, it is invoked before resultCallback.

S’applique à