GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRect&,constStringFormat*) metode (gdipluspath.h)

Artikel
02/29/2024

Metode GraphicsPath::AddString menambahkan kerangka string ke jalur ini.

Sintaks

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

Parameter

[in] string

Jenis: const WCHAR*

Penunjuk ke string karakter lebar.

[in] length

Jenis: INT

Bilangan bulat yang menentukan jumlah karakter yang akan ditampilkan. Jika parameter string menunjuk ke string yang dihentikan NULL, parameter ini dapat diatur ke –1.

[in] family

Jenis: const FontFamily*

Penunjuk ke objek FontFamily yang menentukan keluarga font untuk string.

[in] style

Jenis: INT

Bilangan bulat yang menentukan gaya typeface. Nilai ini harus merupakan elemen enumerasi FontStyle atau hasil bitwise ATAU yang diterapkan ke dua atau beberapa elemen ini. Misalnya, FontStyleBold | FontStyleUnderline | FontStyleStrikeout mengatur gaya sebagai kombinasi dari tiga gaya.

[in] emSize

Jenis: REAL

Angka riil yang menentukan ukuran em, dalam unit dunia, dari karakter string.

[in, ref] layoutRect

Jenis: const Rect

Referensi ke objek Rect yang menentukan, di unit dunia, persegi panjang pembatas untuk string.

[in] format

Jenis: const StringFormat*

Penunjuk ke objek StringFormat yang menentukan informasi tata letak (perataan, pemangkasan, perhentian tab, dan segitu) untuk 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 .

Keterangan

Perhatikan bahwa GDI+ tidak mendukung font PostScript atau font OpenType yang tidak memiliki kerangka TrueType.

Contoh

Contoh berikut membuat jalur objek GraphicsPath, menambahkan string yang dihentikan NULL ke jalur, lalu menggambar jalur.

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

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	gdipluspath.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll