IInkStrokeDisp ::GetRectangleIntersections, méthode (msinkaut.h)

Recherche les points où un objet IInkStrokeDisp croise un rectangle donné.

Syntaxe

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Paramètres

[in] Rectangle

Rectangle dans les coordonnées d’espace manuscrit , qui décrit la zone de test de positionnement.

[out, retval] Intersections

Lorsque cette méthode est retournée, contient un tableau VARIANT qui indique où le trait croise le rectangle. Les index à virgule flottante de début sont stockés dans les index pairs. Les index à virgule flottante de fin sont stockés dans les indices impairs. La première paire d’index représente la première intersection.

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

Valeur renvoyée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Opération réussie.
E_POINTER
Un paramètre contenait un pointeur non valide.
E_OUTOFMEMORY
Impossible d’allouer l’objet d’assistance du gestionnaire Stroke.
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.

Remarques

Cette méthode retourne un tableau qui indique où le trait croise le rectangle spécifié. Chaque segment du trait qui croise le rectangle est une paire d’index, en alternant avec un index de début suivi d’un index de fin.

Si le trait commence dans le rectangle de test, le premier index est défini sur -1. Si le trait se termine dans le rectangle de test, le dernier index est défini sur -1. Si le trait est entièrement en dehors du rectangle de test, un tableau vide est retourné. Par exemple, si un trait commence à l’intérieur du rectangle de test, laisse les limites du rectangle, retourne à l’intérieur et quitte à nouveau, la méthode GetRectangleIntersections peut renvoyer {-1, 1.4, 5.5, 10.1} pour décrire les deux segments du trait tombant dans le rectangle.

Exigences

Prérequis Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Windows
En-tête msinkaut.h

Voir également

Clip, méthode

FindIntersections, méthode

IInkStrokeDisp, interface