Visual.HitTestCore Metodo

Definizione

Spazio dei nomi:
System.Windows.Media
Assembly:
PresentationCore.dll

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

Overload

Nome Descrizione
HitTestCore(GeometryHitTestParameters)

Determina se un valore geometry si trova all'interno dei limiti dell'oggetto visivo.
HitTestCore(PointHitTestParameters)

Determina se un valore di coordinata del punto si trova all'interno dei limiti dell'oggetto visivo.

HitTestCore(GeometryHitTestParameters)

Determina se un valore geometry si trova all'interno dei limiti dell'oggetto visivo.

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

Parametri

hitTestParameters
GeometryHitTestParameters

Oggetto GeometryHitTestParameters che specifica l'oggetto su cui eseguire l'hit Geometry test.

Valori restituiti

GeometryHitTestResult

Oggetto GeometryHitTestResult che rappresenta il risultato dell'hit test.

Esempio

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

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

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 delimitazione dell'oggetto visivo, anche se la coordinata non rientra nella geometria dell'oggetto visivo.

Si applica a

HitTestCore(PointHitTestParameters)

Determina se un valore di coordinata del punto si trova all'interno dei limiti dell'oggetto visivo.

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

Parametri

hitTestParameters
PointHitTestParameters

Oggetto PointHitTestParameters che specifica l'oggetto su cui eseguire l'hit Point test.

Valori restituiti

HitTestResult

Oggetto HitTestResult che rappresenta l'oggetto Visual restituito da un hit test.

Esempio

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

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

Commenti

È possibile eseguire l'override del supporto di hit testing predefinito sugli 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 delimitazione dell'oggetto visivo, anche se la coordinata non rientra nella geometria dell'oggetto visivo.

Si applica a