ContainerVisual.HitTest Methode

Definition

Gibt das oberste visuelle Objekt eines Treffertests zurück.Return top-most visual object of a hit test.

Überlädt

HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.Returns the top-most visual object of a hit test by specifying a Point.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.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);
override this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult

Parameter

point
Point

Der Punktwert, für den ein Treffertest ausgeführt werden soll.The point value to hit test.

Gibt zurück

Das als HitTestResult-Typ zurückgegebene Ergebnis des Treffertests.The hit test result of the visual returned as a HitTestResult type.

Beispiele

Im folgenden Beispiel wird gezeigt, wie der HitTestResult Rückgabewert aus der HitTest -Methode abgerufen wird.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

Hinweise

Die VisualHit -Eigenschaft des Rückgabewerts stellt das Visual Objekt dar, das gefunden wurde.The VisualHit property of the return value represents the Visual object that was hit.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.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);
override this.HitTest : System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit

Parameter

filterCallback
HitTestFilterCallback

Der Delegat, der es Ihnen ermöglicht, in den Treffertestergebnissen die Teile der visuellen Struktur zu ignorieren, die nicht verarbeitet werden sollen.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

Der Delegat, mit dem die Rückgabe der Treffertestinformationen gesteuert wird.The delegate that is used to control the return of hit test information.

hitTestParameters
HitTestParameters

Definiert den Satz von Parametern für einen Treffertest.Defines the set of parameters for a hit test.

Hinweise

Der filterCallback -Parameter kann NULL sein. in diesem Fall wird er ignoriert.The filterCallback parameter can be null, in which case, it is ignored. Wenn filterCallback resultCallbacknicht nullist, wird es vor aufgerufen.If filterCallback is not null, it is invoked before resultCallback.

Gilt für: