Compartilhar via


Método Graphics::SetTextRenderingHint (gdiplusgraphics.h)

O método Graphics::SetTextRenderingHint define o modo de renderização de texto deste objeto Graphics .

Sintaxe

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

Parâmetros

[in] newMode

Tipo: TextRenderingHint

Elemento da enumeração TextRenderingHint que especifica o processo usado atualmente por este objeto Graphics para renderizar texto.

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

TextRenderingHintClearTypeGridFit só tem suporte no Windows XP e no Windows Server 2003.

Não é possível usar TextRenderingHintClearTypeGridFit junto com CompositingModeSourceCopy.

Exemplos

O exemplo a seguir define a dica de renderização de texto como dois valores diferentes e desenha texto para demonstrar cada valor.

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

   // Set the text rendering hint to TextRenderingHintSingleBitPerPixel. 
   graphics.SetTextRenderingHint(TextRenderingHintSingleBitPerPixel);

   // Draw text.
   graphics.DrawString(
   L"Low quality rendering",
       21,
   &Font(L"Arial", 24),
   PointF(0, 0),
   &SolidBrush(Color(255, 0, 0, 0)));

   // Get the text rendering hint.
   TextRenderingHint hint = graphics.GetTextRenderingHint();

   // Set the text rendering hint to TextRenderingHintAntiAlias. 
   graphics.SetTextRenderingHint(TextRenderingHintAntiAlias);

   // Draw more text to demonstrate the difference.
   graphics.DrawString(
   L"High quality rendering",
       22,
   &Font(L"Arial", 24),
   PointF(0, 50),
   &SolidBrush(Color(255, 0, 0, 0)));
}

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 gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll

Confira também

Suavização com Texto

Compositingmode

Elementos gráficos

Graphics::GetTextRenderingHint

Graphics::SetCompositingMode

Textrenderinghint