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) メソッドをオーバーライドする方法を示しています。 このメソッドをオーバーライドする理由の 1 つは、ヒット テスト プロセス中に追加の機能を提供することです。

// 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) メソッドをオーバーライドする方法を示しています。 このメソッドをオーバーライドする理由の 1 つは、ヒット テスト プロセス中に追加の機能を提供することです。

// 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 の実装が呼び出されます。 オーバーライドされたメソッドは、座標がビジュアル オブジェクトのジオメトリの外側にある場合でも、ヒット テストがビジュアル オブジェクトの外接する四角形内にある場合に呼び出されます。

適用対象