Metodo StringFormat::SetTabStops (gdiplusstringformat.h)

Articolo
08/24/2023

Il metodo StringFormat::SetTabStops imposta gli offset per le tabulazioni in questo oggetto StringFormat .

Sintassi

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

Parametri

[in] firstTabOffset

Tipo: REAL

Numero reale che specifica la posizione di offset iniziale. Questa posizione di offset iniziale è relativa all'origine della stringa e l'offset della prima tabulazione è relativo alla posizione di offset iniziale.

[in] count

Tipo: INT

Intero che specifica il numero di offset di tabulazione nella matrice tabStops .

[in] tabStops

Tipo: const REAL*

Puntatore a una matrice di numeri reali che specificano gli offset di tabulazione. L'offset della prima tabulazione è il primo valore nella matrice, l'offset della seconda tabulazione, il secondo valore nella matrice e così via.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Ogni offset di tabulazione nella matrice tabStops , ad eccezione del primo, è relativo a quello precedente. Il primo offset di tabulazione è relativo alla posizione di offset iniziale specificata da firstTabOffset. Ad esempio, se la posizione di offset iniziale è 8 e il primo offset tabulazione è 50, la prima tabulazione si trova nella posizione 58. Se la posizione di offset iniziale è zero, il primo offset di tabulazione è relativo alla posizione 0, l'origine della stringa.

Esempio

Nell'esempio seguente viene creato un oggetto StringFormat , vengono impostate le tabulazioni e viene utilizzato l'oggetto StringFormat per disegnare una stringa contenente caratteri di tabulazione (\t). Il codice disegna anche il rettangolo di layout della stringa.

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

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusstringformat.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll

Vedi anche

Formattazione del testo

StringFormat

StringFormat::GetTabStops

Condividi tramite