Grafis::MeasureString(constWCHAR*,INT,constFont*,constSizeF&,constStringFormat*,SizeF*,INT*,INT*) metode (gdiplusgraphics.h)

Metode Graphics::MeasureString mengukur tingkat string dalam font, format, dan persegi tata letak yang ditentukan.

Sintaks

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
);

Parameter

[in] string

Jenis: const WCHAR*

Penunjuk ke string karakter lebar yang akan diukur.

Penting Untuk bahasa dua arah, seperti Arab, panjang string tidak boleh melebihi 2046 karakter.
 

[in] length

Jenis: INT

Bilangan bulat yang menentukan jumlah karakter dalam array string . Parameter panjang dapat diatur ke –1 jika string dihentikan null.

[in] font

Jenis: font* const

Penunjuk ke objek Font yang menentukan nama keluarga, ukuran, dan gaya font yang diterapkan ke string.

[in, ref] layoutRectSize

Jenis: const SizeF

Referensi ke objek SizeF yang menentukan lebar dan tinggi persegi panjang yang mengikat string.

[in] stringFormat

Jenis: const StringFormat*

Penunjuk ke objek StringFormat yang menentukan informasi tata letak, seperti perataan, pemangkasan, perhentian tab, dan sebagainya.

[out] size

Jenis: SizeF*

Penunjuk ke objek SizeF yang menerima lebar dan tinggi persegi panjang yang mengikat string.

[out] codepointsFitted

Jenis: INT*

Pilihan. Penunjuk ke INT yang menerima jumlah karakter yang benar-benar pas dengan persegi tata letak. Nilai defaultnya adalah penunjuk NULL .

[out] linesFilled

Jenis: INT*

Pilihan. Penunjuk ke INT yang menerima jumlah baris yang benar-benar pas dengan persegi tata letak. Nilai defaultnya adalah penunjuk NULL .

Mengembalikan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan OK, yang merupakan elemen enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Persyaratan

   
Klien minimum yang didukung Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header gdiplusgraphics.h (termasuk Gdiplus.h)
Pustaka Gdiplus.lib
DLL Gdiplus.dll

Lihat juga

Metode DrawString

Font

Grafik

RectF

Format String