Visual.HitTestCore Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bestimmt, ob sich ein Punkt- oder Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.
Überlädt
| Name | Beschreibung |
|---|---|
| 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.GeometryHitTestResultProtected Overridable Function HitTestCore (hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResultParameter
- hitTestParameters
- GeometryHitTestParameters
Ein GeometryHitTestParameters Objekt, das den Geometry Treffertest angibt.
Gibt zurück
Ein GeometryHitTestResult Wert, der das Ergebnis des Treffertests darstellt.
Beispiele
Das folgende Beispiel zeigt, wie die HitTestCore(GeometryHitTestParameters) Methode überschreibt wird. Ein Grund, warum Sie diese Methode außer Kraft setzen möchten, besteht darin, während des Treffertests 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 die standardmäßige Unterstützung für Treffertests für ein visuelles Objekt außer Kraft setzen, indem Sie die HitTestCore Methode überschreiben. Das heißt, wenn Sie die HitTest-Methode aufrufen, wird Ihre überschriebene Implementierung von HitTestCore aufgerufen. Die überschriebene Methode wird aufgerufen, wenn ein Treffertest in das umgebende Rechteck des visuellen Objekts fällt, auch wenn die Koordinate außerhalb der Geometrie des visuellen Objekts liegt.
Gilt für:
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.HitTestResultProtected Overridable Function HitTestCore (hitTestParameters As PointHitTestParameters) As HitTestResultParameter
- hitTestParameters
- PointHitTestParameters
Ein PointHitTestParameters Objekt, das den Point Treffertest angibt.
Gibt zurück
A HitTestResult that represents the Visual that is returned from a hit test.
Beispiele
Das folgende Beispiel zeigt, wie die HitTestCore(PointHitTestParameters) Methode überschreibt wird. Ein Grund, warum Sie diese Methode außer Kraft setzen möchten, besteht darin, während des Treffertests 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 Unterstützung für Treffertests für visuelle Objekte außer Kraft setzen, indem Sie die HitTestCore Methode überschreiben. Das heißt, wenn Sie die HitTest-Methode aufrufen, wird Ihre überschriebene Implementierung von HitTestCore aufgerufen. Die überschriebene Methode wird aufgerufen, wenn ein Treffertest in das umgebende Rechteck des visuellen Objekts fällt, auch wenn die Koordinate außerhalb der Geometrie des visuellen Objekts liegt.
