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

Artikel
01/10/2024

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 PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [out]     RectF              *boundingBox
);

Parameter

[in] string

Jenis: const WCHAR*

Penunjuk ke string karakter lebar yang akan diukur.

Penting Untuk bahasa dua arah, seperti Bahasa 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] origin

Jenis: const PointF

Referensi ke titik di mana string dimulai.

[in] stringFormat

Jenis: const StringFormat*

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

[out] boundingBox

Jenis: RectF*

Penunjuk ke objek RectF yang menerima persegi panjang yang mengikat string.

Nilai kembali

Jenis: Status

Jika metode berhasil, metode mengembalikan OK, yang merupakan elemen dari 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