Graphics::MeasureString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,RectF*,INT*,INT*) (gdiplusgraphics.h)
Il metodo Graphics::MeasureString misura l'extent della stringa nel tipo di carattere, nel formato e nel rettangolo di layout specificati.
Sintassi
Status MeasureString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
RectF *boundingBox,
INT *codepointsFitted,
INT *linesFilled
);
Parametri
string
Puntatore a una stringa di caratteri wide da misurare.
Importante Per le lingue bidirezionali, ad esempio l'arabo, la lunghezza della stringa non deve superare i 2046 caratteri.
length
Intero che specifica il numero di caratteri nella matrice di stringhe . Il parametro length può essere impostato su -1 se la stringa è terminata null.
font
Puntatore a un oggetto Font che specifica il nome della famiglia, le dimensioni e lo stile del tipo di carattere da applicare alla stringa.
layoutRect
Riferimento al rettangolo che delimita la stringa.
stringFormat
Puntatore a un oggetto StringFormat che specifica le informazioni sul layout, ad esempio allineamento, taglio, tabulazioni e così via.
boundingBox
Puntatore a un oggetto RectF che riceve il rettangolo che delimita la stringa.
codepointsFitted
facoltativo. Puntatore a un INT che riceve il numero di caratteri che rientrano effettivamente nel rettangolo di layout. Il valore predefinito è un puntatore NULL .
linesFilled
facoltativo. Puntatore a un INT che riceve il numero di righe che rientrano nel rettangolo di layout. Il valore predefinito è un puntatore NULL .
Valore restituito
Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .
Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .
Commenti
Esempi
Nell'esempio seguente vengono misurate le dimensioni di una stringa e quindi viene disegnato un rettangolo che rappresenta tale dimensione.
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);
}
Requisiti
| Intestazione | gdiplusgraphics.h |