Partager via


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

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

Voir aussi

HitTest(Point[], Single), méthode

Méthode HitTest(Rectangle, Single)

IInkDisp

Classe InkDisp

InkStrokes Collection