Visual.HitTestCore Methode

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Bestimmt, ob sich ein Punkt oder ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.

Überlädt

HitTestCore(GeometryHitTestParameters)	Bestimmt, ob sich ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.
HitTestCore(PointHitTestParameters)	Bestimmt, ob sich ein Punktkoordinatenwert innerhalb der Grenzen des visuellen Objekts befindet.

HitTestCore(GeometryHitTestParameters)

Bestimmt, ob sich ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.

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

Parameter

hitTestParameters

GeometryHitTestParameters

Ein GeometryHitTestParameters-Objekt, das den Geometry angibt, der auf Treffer getestet werden soll.

Gibt zurück

GeometryHitTestResult

Ein GeometryHitTestResult, das das Ergebnisse des Treffertests darstellt.

Beispiele

Im folgenden Beispiel sehen Sie, wie die HitTestCore(GeometryHitTestParameters)-Methode überschrieben wird. Ein Grund, aus dem Sie diese Methode außer Kraft setzen möchten, besteht darin, während des Treffertestvorgangs zusätzliche Funktionen bereitzustellen.

// 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

Hinweise

Sie können standardmäßige Treffertests für ein visuelles Objekt außer Kraft setzen, indem Sie die HitTestCore Methode außer Kraft setzen. Dies bedeutet, dass beim Aufrufen der HitTest Methode die außer Kraft gesetzte Implementierung HitTestCore aufgerufen wird. Die überschriebene Methode wird aufgerufen, wenn ein Treffertest innerhalb des gebundenen Rechtecks des visuellen Objekts fällt, auch wenn die Koordinate außerhalb der Geometrie des visuellen Objekts fällt.

HitTestCore(PointHitTestParameters)

Bestimmt, ob sich ein Punktkoordinatenwert innerhalb der Grenzen des visuellen Objekts befindet.

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

Parameter

hitTestParameters

PointHitTestParameters

Ein PointHitTestParameters-Objekt, das den Point angibt, der auf Treffer getestet werden soll.

Gibt zurück

HitTestResult

Ein HitTestResult, das das von einem Treffertest zurückgegebene Visual darstellt.

Beispiele

Im folgenden Beispiel sehen Sie, wie die HitTestCore(PointHitTestParameters)-Methode überschrieben wird. Ein Grund, aus dem Sie diese Methode außer Kraft setzen möchten, besteht darin, während des Treffertestvorgangs zusätzliche Funktionen bereitzustellen.

// 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

Hinweise

Sie können die Standardmäßige Treffertestunterstützung für visuelle Objekte außer Kraft setzen, indem Sie die HitTestCore Methode außer Kraft setzen. Dies bedeutet, dass beim Aufrufen der HitTest Methode die außer Kraft gesetzte Implementierung HitTestCore aufgerufen wird. Die überschriebene Methode wird aufgerufen, wenn ein Treffertest innerhalb des gebundenen Rechtecks des visuellen Objekts fällt, auch wenn die Koordinate außerhalb der Geometrie des visuellen Objekts fällt.