Méthode IInkStrokeDisp ::NearestPoint (msinkaut.h)
Recherche l’emplacement sur le trait le plus proche d’un point connu et retourne la distance entre ce point et le trait. Tout est dans les coordonnées de l’espace d’entrée manuscrite.
Syntaxe
HRESULT NearestPoint(
[in] long X,
[in] long Y,
[in, out, optional] float *Distance,
[out, retval] float *Point
);
Paramètres
[in] X
Position x dans l’espace d’entrée manuscrite du point à tester.
[in] Y
Position y dans l’espace d’encre du point à tester.
[in, out, optional] Distance
facultatif. Distance entre le point et le trait. Ce paramètre peut être NULL. La valeur par défaut est 0.
[out, retval] Point
Lorsque cette méthode retourne, contient la valeur d’index à virgule flottante qui représente l’emplacement le plus proche sur le trait.
Un index à virgule flottante est une valeur float qui représente un emplacement situé entre deux points dans le trait. Par exemple, si 0,0 est le premier point du trait et 1,0 est le deuxième point de la course, 0,5 est à mi-chemin entre le premier et le deuxième point. De même, une valeur d’index à virgule flottante de 37,25 représente un emplacement qui est de 25 % le long de la ligne entre les points 37 et 38 du trait.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
Réussite. |
|
Un paramètre contenait un pointeur non valide. |
|
Une erreur non spécifiée s'est produite. |
|
Une exception s’est produite à l’intérieur de la méthode. |
Remarques
Le paramètre distance décrit la distance entre le point et l’enveloppe du trait. Il s’agit de la distance entre les deux points moins la moitié de la largeur du trait.
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
GetRectangleIntersections, méthode