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.

C#

protected virtual System.Windows.Media.GeometryHitTestResult HitTestCore (System.Windows.Media.GeometryHitTestParameters hitTestParameters);

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.

C#

// 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);
}

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.

C#

protected virtual System.Windows.Media.HitTestResult HitTestCore (System.Windows.Media.PointHitTestParameters hitTestParameters);

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.

C#

// 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);
}

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.