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