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

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

Sintaksis

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 NULLdihentikan, 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 merupakan elemen dari 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

Bilangan 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.

Mengembalikan nilai

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.

Komentar

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

Persyaratan

Syarat	Nilai
Header	gdipluspath.h

Lihat juga

Metode AddString

Kliping dengan Wilayah

Membuat dan Menggambar Jalur

Membuat Gradien Jalur

Font

FontFamily

FontStyle

GraphicsPath

PointF

StringFormat

Menggunakan Teks dan Font