Méthode IInkStrokeDisp::FindIntersections (msinkaut.h)

Article
08/25/2023

Récupère les points où cet objet IInkStrokeDisp croise d’autres objets IInkStrokeDisp dans une collection InkStrokes connue.

Syntaxe

HRESULT FindIntersections(
  [in]          IInkStrokes *Strokes,
  [out, retval] VARIANT     *Intersections
);

Paramètres

[in] Strokes

Collection connue de traits utilisées pour calculer les points où ce trait croise les traits de la collection. Si la valeur est NULL, utilisez tous les traits de l’objet InkDisp .

Note La collection connue de traits doit provenir du même objet InkDisp que le trait testé pour l’intersection. S’il ne provient pas du même objet InkDisp , E_INK_MISMATCHED_INK_OBJECT est retourné (voir « valeur HRESULT » ci-dessous). La méthode FindIntersections est la seule interface de programmation d’application (API) Tablet PC qui nécessite que la collection connue de traits provient du même objet InkDisp .

[out, retval] Intersections

Lorsque cette méthode est retournée, contient un tableau de valeurs d’index à virgule flottante qui indiquent les emplacements où ce trait croise les traits au sein d’une collection connue de traits.

Un index à virgule flottante est une valeur flottante qui représente un emplacement entre deux points dans le trait. Par exemple, si 0,0 est le premier point dans le trait et 1,0 est le deuxième point dans le trait, 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 de 25 pour cent le long de la ligne entre les points 37 et 38 du trait.

Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.

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_OUTOFMEMORY	Impossible d’allouer un objet d’assistance de handle IInkStrokeDisp .
E_UNEXPECTED	Paramètre ou type de propriété inattendu.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .
E_INK_INCOMPATIBLE_OBJECT	Le paramètre strokes ne pointe pas vers un objet InkDisp compatible.
E_INK_MISMATCHED_INK_OBJECT	L’objet InkDisp de la collection InkStrokes et cet objet IInkStrokeDisp ne correspondent pas.

Notes

Cette méthode peut déterminer uniquement les points d’intersection.

Spécifications


Client minimal pris en charge	Windows XP Édition Tablette 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

IInkStrokeDisp, interface

InkStrokes Collection

Partager via