Sdílet prostřednictvím


ContainerVisual.HitTest Metoda

Definice

Vrátí nejvýraznější vizuální objekt testu přístupů.

Přetížení

HitTest(Point)

Vrátí nejvýraznější vizuální objekt testu přístupů zadáním Point.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Zahájí test přístupů na objektu ContainerVisual pomocí HitTestFilterCallback objektů a HitTestResultCallback .

HitTest(Point)

Vrátí nejvýraznější vizuální objekt testu přístupů zadáním 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

Parametry

point
Point

Hodnota bodu, která se má provést test.

Návraty

Výsledek testu přístupů vizuálu vrácený HitTestResult jako typ

Příklady

Následující příklad ukazuje, jak načíst návratnou HitTestResult hodnotu z HitTest metody.

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

Poznámky

Vlastnost VisualHit návratové hodnoty představuje Visual objekt, který byl nalezen.

Platí pro

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Zahájí test přístupů na objektu ContainerVisual pomocí HitTestFilterCallback objektů a 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)

Parametry

filterCallback
HitTestFilterCallback

Delegát, který umožňuje ignorovat části vizuálního stromu, které nemáte zájem o zpracování ve výsledcích testů přístupů.

resultCallback
HitTestResultCallback

Delegát, který se používá k řízení vrácení informací o testu shod.

hitTestParameters
HitTestParameters

Definuje sadu parametrů pro test shod.

Poznámky

Parametr filterCallback může mít hodnotu null, v takovém případě se ignoruje. Pokud filterCallback není null, vyvolá se před resultCallback.

Platí pro