Visual.HitTestCore Metodo

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Determina se il valore di un punto o geometria si trova all'interno dei limiti dell’oggetto visivo.

Overload

HitTestCore(GeometryHitTestParameters)	Determina se il valore di una geometria si trova all'interno dei limiti dell’oggetto visivo.
HitTestCore(PointHitTestParameters)	Determina se il valore di coordinata di un punto è all'interno dei limiti dell’oggetto visivo.

HitTestCore(GeometryHitTestParameters)

Determina se il valore di una geometria si trova all'interno dei limiti dell’oggetto visivo.

C#

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

Parametri

hitTestParameters

GeometryHitTestParameters

Oggetto GeometryHitTestParameters in cui è specificato l'oggetto Geometry su cui effettuare l’hit test.

Restituisce

GeometryHitTestResult

Oggetto GeometryHitTestResult che rappresenta il risultato dell’hit test.

Esempio

Nell'esempio seguente viene illustrato come eseguire l'override del metodo HitTestCore(GeometryHitTestParameters). Un motivo per cui è possibile eseguire l'override di questo metodo consiste nel fornire funzionalità aggiuntive durante il processo di hit testing.

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

Commenti

È possibile eseguire l'override del supporto di hit testing predefinito per un oggetto visivo eseguendo l'override del HitTestCore metodo . Ciò significa che quando si richiama il HitTest metodo, viene chiamata l'implementazione sottoposta a override di HitTestCore . Il metodo sottoposto a override viene chiamato quando un hit test rientra nel rettangolo di associazione dell'oggetto visivo, anche se la coordinata rientra all'esterno della geometria dell'oggetto visivo.

HitTestCore(PointHitTestParameters)

Determina se il valore di coordinata di un punto è all'interno dei limiti dell’oggetto visivo.

C#

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

Parametri

hitTestParameters

PointHitTestParameters

Oggetto PointHitTestParameters in cui è specificato l'oggetto Point su cui effettuare l’hit test.

Restituisce

HitTestResult

Oggetto HitTestResult che rappresenta il Visual restituito da un hit test.

Esempio

Nell'esempio seguente viene illustrato come eseguire l'override del metodo HitTestCore(PointHitTestParameters). Un motivo per cui è possibile eseguire l'override di questo metodo consiste nel fornire funzionalità aggiuntive durante il processo di hit testing.

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

Commenti

È possibile eseguire l'override del supporto di hit testing predefinito negli oggetti visivi eseguendo l'override del HitTestCore metodo . Ciò significa che quando si richiama il HitTest metodo, viene chiamata l'implementazione sottoposta a override di HitTestCore . Il metodo sottoposto a override viene chiamato quando un hit test rientra nel rettangolo di associazione dell'oggetto visivo, anche se la coordinata rientra all'esterno della geometria dell'oggetto visivo.