ContainerVisual.HitTest ContainerVisual.HitTest ContainerVisual.HitTest Method

Определение

Возвращает самый верхний визуальный объект проверки нажатия.Return top-most visual object of a hit test.

Перегрузки

HitTest(Point) HitTest(Point) HitTest(Point)

Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип Point.Returns the top-most visual object of a hit test by specifying a Point.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point) HitTest(Point) HitTest(Point)

Возвращает самый верхний визуальный объект для проверки нажатия, указывая тип Point.Returns the top-most visual object of a hit test by specifying a 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

Параметры

point
Point Point Point

Значение точки для проверки нажатия.The point value to hit test.

Возвраты

Результат проверки нажатия визуального элемента, возвращенный в виде типа HitTestResult.The hit test result of the visual returned as a HitTestResult type.

Примеры

В следующем примере показано, HitTestResult как получить возвращаемое значение HitTest из метода.The following example shows how to retrieve the HitTestResult return value from the HitTest method.

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

Комментарии

Свойство возвращаемого значения представляет объект, который был достигнут. Visual VisualHitThe VisualHit property of the return value represents the Visual object that was hit.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Инициирует проверку нажатия для ContainerVisual с использованием объектов HitTestFilterCallback и HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

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

Параметры

filterCallback
HitTestFilterCallback HitTestFilterCallback HitTestFilterCallback

Делегат, позволяющий пропустить части визуального дерева, которые не нужно возвращать в результатах проверки нажатия.The delegate that allows you to ignore parts of the visual tree that you are not interested in processing in your hit test results.

resultCallback
HitTestResultCallback HitTestResultCallback HitTestResultCallback

Делегат, используемый для управления информацией, возвращаемой в результатах проверки нажатия.The delegate that is used to control the return of hit test information.

hitTestParameters
HitTestParameters HitTestParameters HitTestParameters

Определяет набор параметров для проверки нажатия.Defines the set of parameters for a hit test.

Комментарии

filterCallback Параметр может иметь значение null, в этом случае он игнорируется.The filterCallback parameter can be null, in which case, it is ignored. Если filterCallback не resultCallbackимеет значение ,оновызываетсяраньше.nullIf filterCallback is not null, it is invoked before resultCallback.

Применяется к