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

Article
03/04/2024

Récupère les traits dans une zone de sélection polyligne.

Syntaxe

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Paramètres

[in] Points

Points utilisés dans l’outil de sélection pour sélectionner les traits. La zone de sélection est la zone à l’intérieur de la limite de sélection dans laquelle la limite se croise pour la première fois. Si la limite ne se croise pas, la méthode ajoute un point à la fin du tableau pour créer une ligne droite du premier point au dernier point. Si la limite est une ligne droite (aucune zone dans la limite de sélection), aucun trait n’est sélectionné.

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

[in] IntersectPercent

Pourcentage de points de trait qui doivent être contenus dans l’outil de sélection pour inclure le trait dans la collection de traits résultante. Si la valeur est égale à zéro (0), tous les traits contenus dans ou croisés par l’outil de sélection sont inclus dans la collection de traits résultante. Si la valeur est 100, seuls les traits entièrement contenus dans l’outil de sélection sont inclus dans la collection. Les traits qui croisent l’outil de sélection sont inclus dans la collection si le pourcentage de points dans ces traits contenus dans l’outil de sélection est supérieur ou égal au pourcentage pourcentageIntersect . Les pourcentages fractionnaires sont arrondis vers le haut.

[in, out, optional] LassoPoints

facultatif. Récupère la partie spécifique de l’outil de sélection utilisée pour la sélection. Étant donné qu’un utilisateur peut dessiner de nombreux types d’outils de sélection différents, dont certains se chevauchent plusieurs fois, cela peut être utile pour illustrer la partie de l’outil de sélection qui a été utilisée pour la sélection. La valeur par défaut est un pointeur NULL , ce qui signifie qu’aucune information n’est retournée.

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

[out, retval] Strokes

Lorsque cette méthode est retournée, contient un pointeur vers la collection de traits qui compose l’entrée manuscrite.

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_OUTOFMEMORY	Impossible d’allouer l’opération de mémoire.

Configuration requise

Condition requise	Valeur
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

HitTest(Point, Single), méthode

HitTest(Rectangle, Single), méthode

IInkDisp

InkDisp, classe

InkStrokes Collection

Partager via