ContainerVisual.HitTest Metodo

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Restituisce l'oggetto visivo di primo livello di un hit test.

Overload

HitTest(Point)	Restituisce l'oggetto visivo in primo piano di un hit test specificando Point.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Avvia un hit test su ContainerVisual, usando gli oggetti HitTestFilterCallback e HitTestResultCallback.

HitTest(Point)

Restituisce l'oggetto visivo in primo piano di un hit test specificando 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

Parametri

point

Point

Valore del punto per l'hit test.

Restituisce

HitTestResult

Risultato dell'hit test dell'oggetto visivo restituito come tipo HitTestResult.

Esempio

Nell'esempio HitTest seguente viene illustrato come recuperare il HitTestResult valore restituito dal metodo .

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

Commenti

La VisualHit proprietà del valore restituito rappresenta l'oggetto Visual raggiunto.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Avvia un hit test su ContainerVisual, usando gli oggetti HitTestFilterCallback e 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)

Parametri

filterCallback

HitTestFilterCallback

Delegato che consente di ignorare parti della struttura ad albero visuale da non elaborare nei risultati dell'hit test.

resultCallback

HitTestResultCallback

Delegato usato per controllare il valore restituito delle informazioni relative all'hit test.

hitTestParameters

HitTestParameters

Definisce il set di parametri per un hit test.

Commenti

Il filterCallback parametro può essere Null, in questo caso viene ignorato. Se filterCallback non nullè , viene richiamato prima resultCallbackdi .