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

Article
08/24/2023

Récupère l’IInkStrokeDisp dans l’objet InkDisp le plus proche d’un point connu, en fournissant éventuellement l’index du point le plus proche et la distance entre le trait et le point spécifié.

Syntaxe

HRESULT NearestPoint(
  [in]                long           X,
  [in]                long           Y,
  [in, out, optional] float          *PointOnStroke,
  [in, out, optional] float          *DistanceFromPacket,
  [out, retval]       IInkStrokeDisp **Stroke
);

Paramètres

[in] X

Position x- dans l’espace d’encre du point.

[in] Y

Spécifie la position dans l’espace y- d’entrée manuscrite du point.

[in, out, optional] PointOnStroke

Optionnel. Récupère le point sur la ligne du trait qui est le plus proche du point spécifié dans l’objet InkDisp . Par exemple, une valeur de 1,5 indique que le point se situe à mi-chemin entre les premier et deuxième paquets du trait. Ce paramètre peut être NULL. La valeur par défaut est 0.

[in, out, optional] DistanceFromPacket

Optionnel. Récupère la distance entre le point spécifié dans l’espace manuscrit et le trait le plus proche de l’objet InkDisp . Ce paramètre peut être NULL. la valeur par défaut est 0.

[out, retval] Stroke

Lorsque cette méthode retourne, contient l’IInkStrokeDisp qui contient un point le plus proche du point spécifié dans l’objet InkDisp . Si plusieurs traits contiennent un point qui est à la même distance du point spécifié, la valeur de ce résultat est arbitraire.

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_FAIL	Une erreur non spécifiée s'est produite.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode.
E_OUTOFMEMORY	Impossible d’allouer l’opération de mémoire.

Notes

Le paramètre de point de sortie est défini comme un nombre à virgule flottante, car le point sur la ligne du trait peut se trouver entre deux points de coordonnées physiques. Utilisez cette valeur pour fractionner le trait avec la méthode Split , ou arrondir la valeur vers le haut ou vers le bas pour indexer un paquet dans le trait.

Le paramètre distanceFromPacket 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


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

IInkDisp

IInkStrokeDisp, interface

Classe InkDisp

NearestPoint, méthode [interface IInkStrokeDisp]

Split, méthode

Partager via