Visual.HitTestCore 메서드

정의

네임스페이스:

System.Windows.Media

어셈블리:

PresentationCore.dll

점 또는 기하 도형 값이 시각적 개체의 경계 내에 있는지 확인합니다.

오버로드

HitTestCore(GeometryHitTestParameters)	기하 도형 값이 시각적 개체의 경계 내에 있는지 확인합니다.
HitTestCore(PointHitTestParameters)	점 좌표 값이 시각적 개체의 경계 내에 있는지 확인합니다.

HitTestCore(GeometryHitTestParameters)

기하 도형 값이 시각적 개체의 경계 내에 있는지 확인합니다.

protected:
 virtual System::Windows::Media::GeometryHitTestResult ^ HitTestCore(System::Windows::Media::GeometryHitTestParameters ^ hitTestParameters);

protected virtual System.Windows.Media.GeometryHitTestResult HitTestCore (System.Windows.Media.GeometryHitTestParameters hitTestParameters);

abstract member HitTestCore : System.Windows.Media.GeometryHitTestParameters -> System.Windows.Media.GeometryHitTestResult
override this.HitTestCore : System.Windows.Media.GeometryHitTestParameters -> System.Windows.Media.GeometryHitTestResult

Protected Overridable Function HitTestCore (hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResult

매개 변수

hitTestParameters

GeometryHitTestParameters

적중 테스트를 수행할 대상 GeometryHitTestParameters를 지정하는 Geometry 개체입니다.

반환

GeometryHitTestResult

적중 테스트 결과를 나타내는 GeometryHitTestResult입니다.

예제

다음 예제에서는 HitTestCore(GeometryHitTestParameters) 메서드를 재정의하는 방법을 보여 줍니다. 이 메서드를 재정의할 수 있는 한 가지 이유는 적중 테스트 프로세스 중에 추가 기능을 제공하기 위해서입니다.

// Override default hit test support in visual object.
protected override GeometryHitTestResult HitTestCore(GeometryHitTestParameters hitTestParameters)
{
    IntersectionDetail intersectionDetail = IntersectionDetail.NotCalculated;

    // Perform custom actions during the hit test processing.

    return new GeometryHitTestResult(this, intersectionDetail);
}

' Override default hit test support in visual object.
Protected Overrides Overloads Function HitTestCore(ByVal hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResult
    Dim intersectionDetail As IntersectionDetail = IntersectionDetail.NotCalculated

    ' Perform custom actions during the hit test processing.

    Return New GeometryHitTestResult(Me, intersectionDetail)
End Function

설명

메서드를 재정의하여 시각적 개체에 대한 기본 적중 테스트 지원을 재정의할 HitTestCore 수 있습니다. 즉, 메서드를 HitTest 호출할 때 재정의 HitTestCore 된 구현이 호출됩니다. 좌표가 시각적 개체의 기하 도형을 벗어나더라도 적중 테스트가 시각적 개체의 경계 사각형 내에 있을 때 재정의된 메서드가 호출됩니다.

HitTestCore(PointHitTestParameters)

점 좌표 값이 시각적 개체의 경계 내에 있는지 확인합니다.

protected:
 virtual System::Windows::Media::HitTestResult ^ HitTestCore(System::Windows::Media::PointHitTestParameters ^ hitTestParameters);

protected virtual System.Windows.Media.HitTestResult HitTestCore (System.Windows.Media.PointHitTestParameters hitTestParameters);

abstract member HitTestCore : System.Windows.Media.PointHitTestParameters -> System.Windows.Media.HitTestResult
override this.HitTestCore : System.Windows.Media.PointHitTestParameters -> System.Windows.Media.HitTestResult

Protected Overridable Function HitTestCore (hitTestParameters As PointHitTestParameters) As HitTestResult

매개 변수

hitTestParameters

PointHitTestParameters

적중 테스트를 수행할 대상 PointHitTestParameters를 지정하는 Point 개체입니다.

반환

HitTestResult

적중 테스트에서 반환되는 HitTestResult을 나타내는 Visual입니다.

예제

다음 예제에서는 HitTestCore(PointHitTestParameters) 메서드를 재정의하는 방법을 보여 줍니다. 이 메서드를 재정의할 수 있는 한 가지 이유는 적중 테스트 프로세스 중에 추가 기능을 제공하기 위해서입니다.

// Override default hit test support in visual object.
protected override HitTestResult HitTestCore(PointHitTestParameters hitTestParameters)
{
    Point pt = hitTestParameters.HitPoint;

    // Perform custom actions during the hit test processing,
    // which may include verifying that the point actually
    // falls within the rendered content of the visual.

    // Return hit on bounding rectangle of visual object.
    return new PointHitTestResult(this, pt);
}

' Override default hit test support in visual object.
Protected Overrides Overloads Function HitTestCore(ByVal hitTestParameters As PointHitTestParameters) As HitTestResult
    Dim pt As Point = hitTestParameters.HitPoint

    ' Perform custom actions during the hit test processing,
    ' which may include verifying that the point actually
    ' falls within the rendered content of the visual.

    ' Return hit on bounding rectangle of visual object.
    Return New PointHitTestResult(Me, pt)
End Function

설명

메서드를 재정의하여 시각적 개체에 대한 기본 적중 테스트 지원을 재정의할 HitTestCore 수 있습니다. 즉, 메서드를 HitTest 호출할 때 재정의 HitTestCore 된 구현이 호출됩니다. 좌표가 시각적 개체의 기하 도형을 벗어나더라도 적중 테스트가 시각적 개체의 경계 사각형 내에 있을 때 재정의된 메서드가 호출됩니다.