Método StringFormat::SetTabStops (gdiplusstringformat.h)

O método StringFormat::SetTabStops define os deslocamentos para paradas de tabulação neste objeto StringFormat .

Sintaxe

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

Parâmetros

[in] firstTabOffset

Tipo: REAL

Número real que especifica a posição de deslocamento inicial. Essa posição de deslocamento inicial é relativa à origem da cadeia de caracteres e o deslocamento da primeira parada de tabulação é relativo à posição inicial de deslocamento.

[in] count

Tipo: INT

Inteiro que especifica o número de deslocamentos de parada de tabulação na matriz tabStops .

[in] tabStops

Tipo: const REAL*

Ponteiro para uma matriz de números reais que especificam os deslocamentos de parada de tabulação. O deslocamento da primeira parada de tabulação é o primeiro valor na matriz, o deslocamento da segunda parada de tabulação, o segundo valor na matriz e assim por diante.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Cada deslocamento de parada de tabulação na matriz tabStops , exceto o primeiro, é relativo ao anterior. O primeiro deslocamento de parada de tabulação é relativo à posição de deslocamento inicial especificada por firstTabOffset. Por exemplo, se a posição inicial de deslocamento for 8 e o primeiro deslocamento de parada de tabulação for 50, a primeira parada de tabulação estará na posição 58. Se a posição inicial de deslocamento for zero, o primeiro deslocamento de parada de tabulação será relativo à posição 0, a origem da cadeia de caracteres.

Exemplos

O exemplo a seguir cria um objeto StringFormat , define paradas de tabulação e usa o objeto StringFormat para desenhar uma cadeia de caracteres que contém caracteres de tabulação (\t). O código também desenha o retângulo de layout da cadeia de caracteres.

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

Requisitos

Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusstringformat.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Formatação de texto

StringFormat

StringFormat::GetTabStops