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

Metode Graphics::D rawString menggambar string berdasarkan font, persegi tata letak, dan format.

Sintaks

Status DrawString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  const Brush        *brush
);

Parameter

string

Penunjuk ke string karakter lebar yang akan digambar.

length

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

font

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

layoutRect

Referensi ke persegi panjang yang mengikat string.

stringFormat

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

brush

Pointer ke objek Brush yang digunakan untuk mengisi string.

Mengembalikan nilai

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 dalam persegi panjang tata letak.

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

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

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

   // Draw layoutRect.
   graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}

Persyaratan

Header	gdiplusgraphics.h

Lihat juga

Grafik

Font

Pena

RectF

StringFormat