Visual.HitTestCore Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Détermine si la valeur d'un point ou d'une géométrie s'inscrit dans les limites de l'objet visuel.

Surcharges

HitTestCore(GeometryHitTestParameters)	Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel.
HitTestCore(PointHitTestParameters)	Détermine si la valeur de coordonnée d'un point s'inscrit dans les limites de l'objet visuel.

HitTestCore(GeometryHitTestParameters)

Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel.

C#

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

Paramètres

hitTestParameters

GeometryHitTestParameters

Objet GeometryHitTestParameters qui spécifie le Geometry par rapport auquel effectuer le test de positionnement.

Retours

GeometryHitTestResult

GeometryHitTestResult qui représente le résultat du test de positionnement.

Exemples

L'exemple suivant montre comment substituer la méthode HitTestCore(GeometryHitTestParameters). Une des raisons pour lesquelles vous souhaiterez peut-être remplacer cette méthode consiste à fournir des fonctionnalités supplémentaires pendant le processus de test de positionnement.

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

Remarques

Vous pouvez remplacer la prise en charge des tests de positionnement par défaut pour un objet visuel en remplaçant la HitTestCore méthode. Cela signifie que lorsque vous appelez la HitTest méthode, votre implémentation HitTestCore substituée est appelée. Votre méthode substituée est appelée lorsqu’un test de positionnement se trouve dans le rectangle englobant de l’objet visuel, même si la coordonnée se trouve en dehors de la géométrie de l’objet visuel.

HitTestCore(PointHitTestParameters)

Détermine si la valeur de coordonnée d'un point s'inscrit dans les limites de l'objet visuel.

C#

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

Paramètres

hitTestParameters

PointHitTestParameters

Objet PointHitTestParameters qui spécifie le Point par rapport auquel effectuer le test de positionnement.

Retours

HitTestResult

HitTestResult qui représente le Visual retourné à partir d'un test de positionnement.

Exemples

L'exemple suivant montre comment substituer la méthode HitTestCore(PointHitTestParameters). Une des raisons pour lesquelles vous souhaiterez peut-être remplacer cette méthode consiste à fournir des fonctionnalités supplémentaires pendant le processus de test de positionnement.

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

Remarques

Vous pouvez remplacer la prise en charge des tests de positionnement par défaut sur les objets visuels en remplaçant la HitTestCore méthode. Cela signifie que lorsque vous appelez la HitTest méthode, votre implémentation HitTestCore substituée est appelée. Votre méthode substituée est appelée lorsqu’un test de positionnement se trouve dans le rectangle englobant de l’objet visuel, même si la coordonnée se trouve en dehors de la géométrie de l’objet visuel.