ContainerVisual.HitTest Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das visuelle Top-Objekt eines Treffertests zurück.
Überlädt
| Name | Beschreibung |
|---|---|
| HitTest(Point) |
Gibt das am häufigsten visuelle Objekt eines Treffertests zurück, indem ein Point. |
| HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) |
Initiiert einen Treffertest mit den ContainerVisualHitTestFilterCallback Und-Objekten HitTestResultCallback . |
HitTest(Point)
Gibt das am häufigsten visuelle Objekt eines Treffertests zurück, indem ein 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
Parameter
- point
- Point
Der Punktwert, der beim Treffertest getestet werden soll.
Gibt zurück
Das Treffertestergebnis des visuellen Elements, das als HitTestResult Typ zurückgegeben wird.
Beispiele
Das folgende Beispiel zeigt, wie der HitTestResult Rückgabewert aus der HitTest Methode abgerufen wird.
// 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 getroffen wurde.
Gilt für:
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)
Initiiert einen Treffertest mit den ContainerVisualHitTestFilterCallback Und-Objekten 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)
Parameter
- filterCallback
- HitTestFilterCallback
Der Delegat, mit dem Sie Teile der visuellen Struktur ignorieren können, die Sie nicht für die Verarbeitung ihrer Treffertestergebnisse interessieren.
- resultCallback
- HitTestResultCallback
Der Delegat, der zum Steuern der Rückgabe von Treffertestinformationen verwendet wird.
- hitTestParameters
- HitTestParameters
Definiert den Satz von Parametern für einen Treffertest.
Hinweise
Der filterCallback Parameter kann null sein, in diesem Fall wird er ignoriert. Wenn filterCallback nicht null, wird sie vor resultCallback.