語言

Visual.HitTestCore 方法

定義

命名空間:
System.Windows.Media
組件:
PresentationCore.dll

判斷點值或幾何值是否在視覺物件範圍內。

多載

名稱 Description
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

A 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 A 代表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 的覆寫實作。 當你的命中測試落在視覺物件的包圍矩形範圍內時，即使座標位於視覺物件的幾何體之外，也會呼叫你的覆寫方法。

適用於