StringFormat::SetTabStops-Methode (gdiplusstringformat.h)

  • Artikel

Die StringFormat::SetTabStops-Methode legt die Offsets für Tabstopps in diesem StringFormat-Objekt fest.

Syntax

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

Parameter

[in] firstTabOffset

Typ: REAL

Reelle Zahl, die die anfängliche Offsetposition angibt. Diese anfängliche Offsetposition ist relativ zum Ursprung der Zeichenfolge, und der Offset des ersten Tabstopps ist relativ zur anfänglichen Offsetposition.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Tabstoppoffsets im tabStops-Array angibt.

[in] tabStops

Typ: const REAL*

Zeiger auf ein Array von reellen Zahlen, die die Offsets für Tabstopp angeben. Der Offset des ersten Tabstopps ist der erste Wert im Array, der Offset des zweiten Tabstopps, der zweite Wert im Array usw.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Jeder Tabstoppoffset im tabStops-Array , mit Ausnahme des ersten, ist relativ zum vorherigen. Der erste Tabstoppoffset-Offset ist relativ zur anfänglichen Offsetposition, die von firstTabOffset angegeben wird. Wenn beispielsweise die anfängliche Offsetposition 8 und der erste Tabstopp-Offset 50 ist, befindet sich der erste Tabstopp an Position 58. Wenn die anfängliche Offsetposition 0 ist, ist der erste Tabstoppoffset relativ zur Position 0, dem Zeichenfolgenursprung.

Beispiele

Im folgenden Beispiel wird ein StringFormat-Objekt erstellt, Tabstopps festgelegt und das StringFormat-Objekt verwendet, um eine Zeichenfolge zu zeichnen, die Tabulatorzeichen (\t) enthält. Der Code zeichnet auch das Layoutrechteck der Zeichenfolge.

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusstringformat.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Formatieren von Text

StringFormat

StringFormat::GetTabStops