ContainerVisual.HitTest 메서드

정의

적중 횟수 테스트의 최상위 시각적 개체를 반환합니다.Return top-most visual object of a hit test.

오버로드

HitTest(Point)

Point를 지정하여 적중 횟수 테스트의 최상위 시각적 개체를 반환합니다.Returns the top-most visual object of a hit test by specifying a Point.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

HitTestFilterCallbackHitTestResultCallback 개체를 사용하여 ContainerVisual에서 적중 횟수 테스트를 시작합니다.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

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

적중 횟수 테스트의 소수점 값입니다.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

설명

합니다 VisualHit 반환 값의 속성을 나타냅니다는 Visual 적중 된 개체입니다.The VisualHit property of the return value represents the Visual object that was hit.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

HitTestFilterCallbackHitTestResultCallback 개체를 사용하여 ContainerVisual에서 적중 횟수 테스트를 시작합니다.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

적중 횟수 테스트 결과 처리 중 시각적 트리에서 관련이 없는 파트를 무시할 수 있는 대리자입니다.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

적중 횟수 테스트 정보의 반환을 제어하는 데 사용되는 대리자입니다.The delegate that is used to control the return of hit test information.

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 아닙니다 null, 보다 먼저 호출 됩니다 resultCallback합니다.If filterCallback is not null, it is invoked before resultCallback.

적용 대상