StringFormat::SetTabStops, méthode (gdiplusstringformat.h)

La méthode StringFormat::SetTabStops définit les décalages des tabulations de cet objet StringFormat .

Syntaxe

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

Paramètres

[in] firstTabOffset

Type : REAL

Nombre réel qui spécifie la position de décalage initiale. Cette position de décalage initiale est relative à l’origine de la chaîne et le décalage du premier taquet de tabulation est relatif à la position de décalage initiale.

[in] count

Type : INT

Entier qui spécifie le nombre de décalages de taquet de tabulation dans le tableau tabStops .

[in] tabStops

Type : const REAL*

Pointeur vers un tableau de nombres réels qui spécifient les décalages du taquet de tabulation. Le décalage du premier taquet de tabulation est la première valeur du tableau, le décalage du deuxième taquet de tabulation, la deuxième valeur du tableau, et ainsi de suite.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Chaque décalage de taquet de tabulation dans le tableau tabStops , à l’exception du premier, est relatif au précédent. Le premier décalage de tabulation est relatif à la position de décalage initiale spécifiée par firstTabOffset. Par exemple, si la position de décalage initiale est 8 et que le premier décalage de tabulation est 50, le premier taquet de tabulation se trouve à la position 58. Si la position de décalage initiale est égale à zéro, le premier décalage de tabulation est relatif à la position 0, l’origine de la chaîne.

Exemples

L’exemple suivant crée un objet StringFormat , définit des taquets de tabulation et utilise l’objet StringFormat pour dessiner une chaîne qui contient des caractères de tabulation (\t). Le code dessine également le rectangle de disposition de la chaîne.

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

Spécifications

Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusstringformat.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll

Voir aussi

Mise en forme du texte

StringFormat

StringFormat::GetTabStops