Metode StringFormat::SetTabStops (gdiplusstringformat.h)

Metode StringFormat::SetTabStops mengatur offset untuk perhentian tab di objek StringFormat ini.

Sintaks

Status SetTabStops(
  [in] REAL       firstTabOffset,
  [in] INT        count,
  [in] const REAL *tabStops
);

Parameter

[in] firstTabOffset

Jenis: NYATA

Angka riil yang menentukan posisi offset awal. Posisi offset awal ini relatif terhadap asal string dan offset pemberhentian tab pertama relatif terhadap posisi offset awal.

[in] count

Jenis: INT

Bilangan bulat yang menentukan jumlah offset tab-stop dalam array tabStops .

[in] tabStops

Jenis: const REAL*

Penunjuk ke array angka riil yang menentukan offset tab-stop. Offset pemberhentian tab pertama adalah nilai pertama dalam array, offset perhentian tab kedua, nilai kedua dalam array, dan sebagainya.

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

Keterangan

Setiap offset tab-stop di array tabStops , kecuali yang pertama, relatif terhadap yang sebelumnya. Offset pemberhentian tab pertama relatif terhadap posisi offset awal yang ditentukan oleh firstTabOffset. Misalnya, jika posisi offset awal adalah 8 dan offset tab-stop pertama adalah 50, maka perhentian tab pertama berada di posisi 58. Jika posisi offset awal adalah nol, maka offset tab-stop pertama relatif terhadap posisi 0, asal string.

Contoh

Contoh berikut membuat objek StringFormat , mengatur perhentian tab, dan menggunakan objek StringFormat untuk menggambar string yang berisi karakter tab (\t). Kode ini juga menggambar persegi tata letak string.

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

   REAL         tabs[] = {150, 100, 100};
   FontFamily   fontFamily(L"Courier New");
   Font         font(&fontFamily, 12, FontStyleRegular, UnitPoint);
   SolidBrush   solidBrush(Color(255, 0, 0, 255));

   StringFormat stringFormat;
   stringFormat.SetTabStops(0, 3, tabs);
   graphics.DrawString(
      L"Name\tTest 1\tTest 2\tTest 3", 
      25, 
      &font, 
      RectF(20, 20, 500, 100), 
      &stringFormat, 
      &solidBrush);

   // Draw the rectangle that encloses the text.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawRectangle(&pen, 20, 20, 500, 100);
}

Persyaratan

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

Lihat juga

Memformat Teks

StringFormat

StringFormat::GetTabStops