Méthode IInkDisp ::HitTestCircle (msinkaut.h)

Article
03/04/2024

Récupère la collection InkStrokes qui se trouve complètement à l’intérieur ou qui est croisée par un cercle connu.

Syntaxe

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

Paramètres

[in] X

Position x du centre du cercle de test d’impact dans les unités d’espace d’encre.

[in] Y

Position y du centre du cercle de test d’impact dans les unités d’espace d’encre.

[in] radius

Rayon du cercle à utiliser dans le test de succès, dans les unités d’espace d’encre.

[out, retval] Strokes

Lorsque cette méthode retourne, contient la collection de traits qui sont soit complètement à l’intérieur soit croisés par le cercle spécifié.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_POINTER	Un paramètre contenait un pointeur non valide.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode.
E_INVALIDARG	Handle d’affichage non valide.
E_UNEXPECTED	Type de paramètre ou de propriété inattendu.

Remarques

Si un trait croise le cercle, le trait complet est retourné.

La méthode calcule l’intersection, en tenant compte de l’ensemble complet des attributs de dessin qui s’appliquent au trait, y compris la largeur complète du stylet, le lissage de Bézier (le cas échéant) et la forme de la pointe du stylet.

Une fois qu’une rotation ou une transformation de cisaillement a été effectuée sur un trait ou une collection de traits, les coordonnées transformées x- et y- ne sont plus concentriques avec les coordonnées d’origine. Pour cette raison, l’argument radius ne doit pas être calculé à partir des x- coordonnées ou y- .

Pour déterminer les points d’un trait connu qui croisent la zone de test, appelez la méthode HitTest de l’objet IInkStrokeDisp .

L’application doit toujours passer un pointeur de destination pour la collection de traits obtenue. S’il n’y a pas d’intersections, la collection a un nombre de zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll