ContainerVisual.HitTest Метод

Определение

Пространство имен:

System.Windows.Media

Сборка:

PresentationCore.dll

Возвращает самый верхний визуальный объект проверки нажатия.

Перегрузки

HitTest(Point)	Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип Point.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и HitTestResultCallback.

HitTest(Point)

Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип 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

Параметры

point

Point

Значение точки для проверки нажатия.

Возвращаемое значение

HitTestResult

Результат проверки нажатия визуального элемента, возвращенный в виде типа HitTestResult.

Примеры

В следующем примере показано, как получить возвращаемое HitTestResult значение из HitTest метода.

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

Комментарии

Свойство VisualHit возвращаемого значения представляет Visual объект, который был достигнут.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и 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)

Параметры

filterCallback

HitTestFilterCallback

Делегат, позволяющий пропустить части визуального дерева, которые не нужно возвращать в результатах проверки нажатия.

resultCallback

HitTestResultCallback

Делегат, используемый для управления информацией, возвращаемой в результатах проверки нажатия.

hitTestParameters

HitTestParameters

Определяет набор параметров для проверки нажатия.

Комментарии

Параметр filterCallback может иметь значение NULL, в этом случае он игнорируется. Если filterCallback это не nullтак, он вызывается перед resultCallback.