Graphics::MeasureString(constWCHAR,INT,constFont,constSizeF&,constStringFormat,SizeF,INT,INT) (gdiplusgraphics.h)

Articolo
08/24/2023

Il metodo Graphics::MeasureString misura l'estensione 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 SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

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 di lunghezza 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 carattere applicato alla stringa.

[in, ref] layoutRectSize

Tipo: const SizeF

Riferimento a un oggetto SizeF che specifica la larghezza e l'altezza di un rettangolo che delimita la stringa.

[in] stringFormat

Tipo: const StringFormat*

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

[out] size

Tipo: SizeF*

Puntatore a un oggetto SizeF che riceve la larghezza e l'altezza del rettangolo che delimita la stringa.

[out] codepointsFitted

Tipo: INT*

facoltativo. Puntatore a un INT che riceve il numero di caratteri che effettivamente si adattano al rettangolo di layout. Il valore predefinito è un puntatore NULL .

[out] linesFilled

Tipo: INT*

facoltativo. Puntatore a un INT che riceve il numero di righe che effettivamente si adattano al rettangolo di layout. Il valore predefinito è un puntatore NULL .

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce OK, ovvero 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