ContainerVisual.HitTest Methode

  • Referenz

Definition

Namespace:
System.Windows.Media
Assembly:
PresentationCore.dll

Gibt das oberste visuelle Objekt eines Treffertests zurück.

Überlädt

HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.

HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.

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, für den ein Treffertest ausgeführt werden soll.

Gibt zurück

HitTestResult

Das als HitTestResult-Typ zurückgegebene Ergebnis des Treffertests.

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)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.

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

resultCallback
HitTestResultCallback

Der Delegat, mit dem die Rückgabe der Treffertestinformationen gesteuert 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 resultCallbackaufgerufen.

Gilt für: