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

Artikel
01/10/2024

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

Sintaks

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

Parameter

string

Penunjuk ke string karakter lebar.

length

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

family

Penunjuk ke objek FontFamily yang menentukan keluarga font untuk string.

style

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

emSize

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

origin

Referensi ke objek PointF yang menentukan, di unit dunia, lokasi string.

format

Penunjuk ke objek StringFormat yang menentukan informasi tata letak (perataan, pemangkasan, perhentian tab, dan sesukanya) untuk string.

Nilai kembali

Type: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, 
      PointF(50.0f, 50.0f),
      NULL);

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