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

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

Sintaks

Status MeasureString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  RectF              *boundingBox,
  INT                *codepointsFitted,
  INT                *linesFilled
);

Parameter

string

Penunjuk ke string karakter lebar yang akan diukur.

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

length

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

font

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

layoutRect

Referensi ke persegi panjang yang mengikat string.

stringFormat

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

boundingBox

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

codepointsFitted

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

linesFilled

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

Mengembalikan nilai

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

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

Keterangan

Contoh

Contoh berikut mengukur ukuran string lalu menggambar persegi panjang yang mewakili ukuran tersebut.

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

Persyaratan

Header	gdiplusgraphics.h

Lihat juga

Metode DrawString

Font

Grafik

RectF

Format String