Grafik::Metode MeasureDriverString (gdiplusgraphics.h)

Artikel
02/26/2024

Metode Graphics::MeasureDriverString mengukur kotak pembatas untuk karakter yang ditentukan dan posisi yang sesuai.

Sintaks

Status MeasureDriverString(
  [in]  const UINT16 *text,
  [in]  INT          length,
  [in]  const Font   *font,
  [in]  const PointF *positions,
  [in]  INT          flags,
  [in]  const Matrix *matrix,
  [out] RectF        *boundingBox
);

Parameter

[in] text

Jenis: const UINT16*

Penunjuk ke array nilai 16-bit. Jika bendera DriverStringOptionsCmapLookup diatur, setiap nilai menentukan karakter Unicode yang akan ditampilkan. Jika tidak, setiap nilai menentukan indeks ke glyph font yang menentukan karakter yang akan ditampilkan.

[in] length

Jenis: INT

Bilangan bulat yang menentukan jumlah nilai dalam array teks . 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 akan diterapkan ke string.

[in] positions

Jenis: const PointF*

Jika bendera DriverStringOptionsRealizedAdvance diatur, posisi adalah penunjuk ke objek PointF yang menentukan posisi glyph pertama. Jika tidak, posisi adalah array objek PointF , yang masing-masing menentukan asal glyph individu.

[in] flags

Jenis: INT

Bilangan bulat yang menentukan opsi untuk tampilan string. Nilai ini harus merupakan elemen dari enumerasi DriverStringOptions atau hasil bitwise ATAU diterapkan ke dua atau beberapa elemen ini.

[in] matrix

Jenis: const Matrix*

Penunjuk ke objek Matriks yang menentukan matriks transformasi untuk diterapkan ke setiap nilai dalam array teks .

[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

Persyaratan	Nilai
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