Graphics ::MeasureString(constWCHAR*,INT,constFont*,constSizeF&,constStringFormat*,SizeF*,INT*,INT*,INT*) (gdiplusgraphics.h)
La méthode Graphics ::MeasureString mesure l’étendue de la chaîne dans la police, le format et le rectangle de disposition spécifiés.
Syntaxe
Status MeasureString(
[in] const WCHAR *string,
[in] INT length,
[in] const Font *font,
[in, ref] const SizeF & layoutRectSize,
[in] const StringFormat *stringFormat,
[out] SizeF *size,
[out] INT *codepointsFitted,
[out] INT *linesFilled
);
Paramètres
[in] string
Type : const WCHAR*
Pointeur vers une chaîne de caractères larges à mesurer.
[in] length
Type : INT
Entier qui spécifie le nombre de caractères dans le tableau de chaînes . Le paramètre length peut être défini sur –1 si la chaîne est terminée par null.
[in] font
Type : const Font*
Pointeur vers un objet Font qui spécifie le nom de famille, la taille et le style de la police appliquée à la chaîne.
[in, ref] layoutRectSize
Type : const SizeF
Référence à un objet SizeF qui spécifie la largeur et la hauteur d’un rectangle qui limite la chaîne.
[in] stringFormat
Type : const StringFormat*
Pointeur vers un objet StringFormat qui spécifie les informations de disposition, telles que l’alignement, le découpage, les taquets de tabulation, etc.
[out] size
Type : SizeF*
Pointeur vers un objet SizeF qui reçoit la largeur et la hauteur du rectangle qui limite la chaîne.
[out] codepointsFitted
Type : INT*
facultatif. Pointeur vers un INT qui reçoit le nombre de caractères qui s’intègrent réellement dans le rectangle de disposition. La valeur par défaut est un pointeur NULL .
[out] linesFilled
Type : INT*
facultatif. Pointeur vers un INT qui reçoit le nombre de lignes qui tiennent réellement dans le rectangle de disposition. La valeur par défaut est un pointeur NULL .
Valeur retournée
Type : État
Si la méthode réussit, elle retourne OK, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Configuration requise
Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | gdiplusgraphics.h (inclure Gdiplus.h) |
Bibliothèque | Gdiplus.lib |
DLL | Gdiplus.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour