Graphics ::MeasureString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,RectF*,INT*,INT*) méthode (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(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
RectF *boundingBox,
INT *codepointsFitted,
INT *linesFilled
);
Paramètres
string
Pointeur vers une chaîne de caractères larges à mesurer.
Important Pour les langues bidirectionnelles, telles que l’arabe, la longueur de chaîne ne doit pas dépasser 2 046 caractères.
length
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.
font
Pointeur vers un objet Font qui spécifie le nom de famille, la taille et le style de la police à appliquer à la chaîne.
layoutRect
Référence au rectangle qui lie la chaîne.
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.
boundingBox
Pointeur vers un objet RectF qui reçoit le rectangle qui lie la chaîne.
codepointsFitted
facultatif. Pointeur vers un INT qui reçoit le nombre de caractères qui tiennent réellement dans le rectangle de disposition. La valeur par défaut est un pointeur NULL .
linesFilled
facultatif. Pointeur vers un INT qui reçoit le nombre de lignes qui tiennent dans le rectangle de disposition. La valeur par défaut est un pointeur NULL .
Valeur retournée
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 .
Notes
Exemples
L’exemple suivant mesure la taille d’une chaîne, puis dessine un rectangle qui représente cette taille.
VOID Example_MeasureString2(HDC hdc)
{
Graphics graphics(hdc);
// Set up the string.
WCHAR string[] = L"Measure Text";
Font font(L"Arial", 16);
RectF layoutRect(0.0f, 0.0f, 100.0f, 50.0f);
StringFormat format;
format.SetAlignment(StringAlignmentFar);
RectF boundRect;
// Measure the string.
graphics.MeasureString(string, 12, &font, layoutRect, &format, &boundRect);
// Draw a rectangle that represents the size of the string.
graphics.DrawRectangle(&Pen(Color(255, 0, 0, 0)), boundRect);
}
Configuration requise
| En-tête | gdiplusgraphics.h |