Visual.HitTestCore Metoda

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Określa, czy wartość punktu lub geometrii znajduje się w granicach obiektu wizualizacji.

Przeciążenia

HitTestCore(GeometryHitTestParameters)	Określa, czy wartość geometryczna znajduje się w granicach obiektu wizualizacji.
HitTestCore(PointHitTestParameters)	Określa, czy wartość współrzędnych punktu znajduje się w granicach obiektu wizualizacji.

HitTestCore(GeometryHitTestParameters)

Określa, czy wartość geometryczna znajduje się w granicach obiektu wizualizacji.

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

Parametry

hitTestParameters

GeometryHitTestParameters

GeometryHitTestParameters Obiekt, który określa Geometry test trafienia względem.

Zwraca

GeometryHitTestResult

Element GeometryHitTestResult reprezentujący wynik testu trafienia.

Przykłady

W poniższym przykładzie pokazano, jak zastąpić metodę HitTestCore(GeometryHitTestParameters) . Jednym z powodów, dla których warto zastąpić tę metodę, jest zapewnienie dodatkowych funkcji podczas procesu testowania trafień.

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

Uwagi

Możesz zastąpić domyślną obsługę testowania trafień dla obiektu wizualnego, przesłaniając metodę HitTestCore . Oznacza to, że podczas wywoływania HitTest metody wywoływana jest zastępowana implementacja HitTestCore metody . Metoda przesłonięta jest wywoływana, gdy test trafienia mieści się w obrębie prostokąta ograniczenia obiektu wizualizacji, nawet jeśli współrzędna wykracza poza geometrię obiektu wizualizacji.

HitTestCore(PointHitTestParameters)

Określa, czy wartość współrzędnych punktu znajduje się w granicach obiektu wizualizacji.

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

Parametry

hitTestParameters

PointHitTestParameters

PointHitTestParameters Obiekt, który określa Point test trafienia względem.

Zwraca

HitTestResult

Element HitTestResult reprezentujący Visual wynik zwracany z testu trafionego.

Przykłady

W poniższym przykładzie pokazano, jak zastąpić metodę HitTestCore(PointHitTestParameters) . Jednym z powodów, dla których warto zastąpić tę metodę, jest zapewnienie dodatkowych funkcji podczas procesu testowania trafień.

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

Uwagi

Możesz zastąpić domyślną obsługę testowania trafień w obiektach wizualnych, przesłaniając metodę HitTestCore . Oznacza to, że podczas wywoływania HitTest metody wywoływana jest zastępowana implementacja HitTestCore metody . Metoda przesłonięta jest wywoływana, gdy test trafienia mieści się w obrębie prostokąta ograniczenia obiektu wizualizacji, nawet jeśli współrzędna wykracza poza geometrię obiektu wizualizacji.