Graphics::MeasureString(constWCHAR,INT,constFont,constPointF&,constStringFormat,RectF) (gdiplusgraphics.h)

Articolo
01/10/2024

Il metodo Graphics::MeasureString misura l'extent della stringa nel tipo di carattere, nel formato e nel rettangolo di layout specificati.

Sintassi

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [out]     RectF              *boundingBox
);

Parametri

[in] string

Tipo: const WCHAR*

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.

[in] length

Tipo: INT

Intero che specifica il numero di caratteri nella matrice di stringhe . Il parametro length può essere impostato su –1 se la stringa è terminata null.

[in] font

Tipo: carattere const *

Puntatore a un oggetto Font che specifica il nome della famiglia, le dimensioni e lo stile del tipo di carattere applicato alla stringa.

[in, ref] origin

Tipo: const PointF

Riferimento al punto in cui inizia la stringa.

[in] stringFormat

Tipo: const StringFormat*

Puntatore a un oggetto StringFormat che specifica le informazioni sul layout, ad esempio allineamento, taglio, tabulazioni e così via.

[out] boundingBox

Tipo: RectF*

Puntatore a un oggetto RectF che riceve il rettangolo che delimita la stringa.

Valore restituito

Tipo: Stato

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 .

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll