IInkRenderer ::Measure, méthode (msinkaut.h)

Article
02/29/2024

Calcule le rectangle dans le contexte de l’appareil qui contiendrait une collection de traits si les traits ont été dessinés avec l’objet InkRenderer à l’aide de la méthode DrawStroke .

Syntaxe

HRESULT Measure(
  [in]          IInkStrokes   *Strokes,
  [out, retval] IInkRectangle **Rectangle
);

Paramètres

[in] Strokes

Collection de traits à mesurer.

[out, retval] Rectangle

Lorsque cette méthode retourne, contient un pointeur vers le rectangle dans le contexte de l’appareil qui contiendrait les traits s’ils étaient dessinés avec la méthode DrawStroke de l’objet InkRenderer . Les traits doivent contenir des coordonnées x et y pour calculer le rectangle. Sinon, la méthode retourne un rectangle vide.

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_INVALIDARG	Handle d’affichage non valide.
E_INK_INCOMPATIBLE_OBJECT	Le paramètre strokes ne pointe pas vers un objet valide.
E_INK_MISMATCHED_INK_OBJECT	Le paramètre strokes est associé à un autre objet InkDisp .
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode.
E_UNEXPECTED	Type de paramètre ou de propriété inattendu.

Remarques

Cela n’est exact que si vous passez les mêmes arguments à Measure et DrawStroke.

Étant donné que le cadre englobant est affecté par la largeur du stylet, cette largeur est mise à l’échelle de manière appropriée pour la transformation d’affichage de InkRenderer. Pour ce faire, la largeur du stylet est multipliée par la racine carrée du déterminant de la transformation d’affichage. La hauteur et la largeur du cadre englobant sont augmentées de la moitié de cette quantité dans chaque sens, et les côtés droit et inférieur sont incrémentés d’un.

Par exemple, considérez que la largeur du stylet est initialement 53, que la racine carrée du déterminant de la transformation d’affichage est 50 et que le cadre englobant est (0, 0, 1000, 1000). L’ajustement de la largeur du stylet au cadre englobant dans chaque direction est calculé comme (53 * 50) / 2, et les côtés droit et inférieur sont incrémentés d’un. Il en résulte un cadre englobant rendu de (-1325, -1325, 2326, 2326).

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

Draw, méthode [Classe InkRenderer]

IInkRenderer

IInkStrokeDisp, interface

Classe InkRenderer

Méthode MeasureStroke

Partager via