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

Artigo
08/24/2023

O método StringFormat::GenericDefault cria um objeto StringFormat genérico e padrão.

Sintaxe

const StringFormat * GenericDefault();

Valor retornado

Tipo: StringFormat*

Esse método retorna um ponteiro para o novo objeto StringFormat .

Comentários

Um objeto StringFormat genérico e padrão tem as seguintes características:

Nenhum sinalizador de formato de cadeia de caracteres está definido.
O alinhamento de caracteres e o alinhamento da linha são definidos como StringAlignmentNear.
A ID da linguagem é definida como linguagem neutra, o que significa que o idioma atual associado ao thread de chamada é usado.
A substituição de dígito de cadeia de caracteres é definida como StringDigitSubstituteUser.
O prefixo hot key é definido como HotkeyPrefixNone.
O número de paradas de tabulação é definido como zero.
O corte de cadeia de caracteres é definido como StringTrimmingCharacter.

Exemplos

O exemplo a seguir cria um objeto StringFormat genérico e padrão e o usa para desenhar uma cadeia de caracteres formatada. O código também desenha o retângulo de layout da cadeia de caracteres.

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

   SolidBrush  solidBrush(Color(255, 255, 0, 0)); 
   FontFamily  fontFamily(L"Times New Roman");
   Font        font(&fontFamily, 12, FontStyleRegular, UnitPoint);
   
   // Create a generic StringFormat object.
   const StringFormat* pStringFormat = StringFormat::GenericDefault();

   // Use the generic StringFormat object in a call to DrawString.
  graphics.DrawString(
      L"This text was formatted by a generic StringFormat object.", 
      57,  // string length
      &font, 
      RectF(30, 30, 100, 120), 
      pStringFormat, 
      &solidBrush);

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

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