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

Article
03/06/2024

Récupère le cadre englobant dans les coordonnées d’espace d’entrée manuscrite pour tous les traits d’un objet InkDisp , un trait individuel ou une collection InkStrokes .

Syntaxe

HRESULT GetBoundingBox(
  [in, optional] InkBoundingBoxMode BoundingBoxMode,
  [out, retval]  IInkRectangle      **Rectangle
);

Paramètres

[in, optional] BoundingBoxMode

Facultatif. Spécifie les caractéristiques de trait à utiliser pour calculer le cadre englobant. La valeur par défaut est -1, ce qui indique que toutes les caractéristiques d’un trait sont utilisées pour spécifier le cadre englobant.

Pour plus d’informations sur l’utilisation des caractéristiques de trait pour calculer un cadre englobant, consultez le type d’énumération BoundingBoxMode .

[out, retval] Rectangle

Lorsque cette méthode retourne, contient un pointeur vers le rectangle qui définit le cadre englobant d’un objet InkDisp , d’un objet IInkStrokeDisp ou d’une collection InkStrokes .

Note Pour un objet IInkStrokeDisp , le cadre englobant retourné est une copie du cadre englobant des traits, de sorte que la modification du cadre englobant retourné n’affecte pas l’emplacement des traits.

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_UNEXPECTED	Type de paramètre ou de propriété inattendu.
REGDB_CLASSNOTREG	L’objet InkRectangle n’est pas inscrit.

Remarques

Lorsque 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 d’InkRenderer. Pour ce faire, la largeur du stylet est multipliée par la racine carrée du déterminant de la transformation d’affichage.

Note Dans Windows Vista et les versions ultérieures, la méthode GetBoundingBox ne tient pas compte de la largeur du trait.

Note Si vous n’avez pas défini explicitement la largeur du stylet, elle est 53 par défaut. Vous devez multiplier la largeur du stylet par la racine carrée du déterminant pour obtenir le cadre englobant correct. La hauteur et la largeur du cadre englobant sont augmentées de la moitié de cette quantité dans chaque sens. Par exemple, considérez que la largeur du stylet est de 53, que la racine carrée du déterminant 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

IInkStrokeDisp, interface

InkBoundingBoxMode, énumération

Classe InkRectangle

Partager via