Grafis::D rawString(constWCHAR,INT,constFont,constPointF&,constStringFormat,constBrush) metode (gdiplusgraphics.h)

Artikel
02/29/2024

Metode Graphics::D rawString menggambar string berdasarkan font, asal string, dan format.

Sintaks

Status DrawString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [in]      const Brush        *brush
);

Parameter

[in] string

Jenis: const WCHAR*

Penunjuk ke string karakter lebar yang akan digambar.

[in] length

Jenis: INT

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

[in] font

Jenis: font* const

Penunjuk ke objek Font yang menentukan atribut font (nama keluarga, ukuran, dan gaya font) untuk digunakan.

[in, ref] origin

Jenis: const PointF

Referensi ke objek PointF yang menentukan titik awal untuk string.

[in] stringFormat

Jenis: const StringFormat*

Penunjuk ke objek StringFormat yang menentukan informasi tata letak teks dan menampilkan manipulasi yang akan diterapkan ke string.

[in] brush

Jenis: const Brush*

Pointer ke objek Brush yang digunakan untuk mengisi 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.

Saat Menggunakan API GDI+, Anda tidak boleh mengizinkan aplikasi mengunduh font arbitrer dari sumber yang tidak tepercaya. Sistem operasi memerlukan hak istimewa yang ditingkatkan untuk memastikan bahwa semua font yang diinstal tepercaya.

Contoh

Contoh berikut menggunakan pemformatan yang ditentukan untuk menggambar string pada asal yang ditentukan.

VOID Example_DrawString3(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   PointF origin(0.0f, 0.0f);
   SolidBrush blackBrush(Color(255, 0, 0, 0));
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &format,
   &blackBrush);
}

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