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

Artículo
03/14/2023

El método Graphics::SetTextRenderingHint establece el modo de representación de texto de este objeto Graphics .

Sintaxis

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

Parámetros

[in] newMode

Tipo: TextRenderingHint

Elemento de la enumeración TextRenderingHint que especifica el proceso que usa actualmente este objeto Graphics para representar texto.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

TextRenderingHintClearTypeGridFit solo se admite en Windows XP y Windows Server 2003.

No puede usar TextRenderingHintClearTypeGridFit junto con CompositingModeSourceCopy.

Ejemplos

En el ejemplo siguiente se establece la sugerencia de representación de texto en dos valores diferentes y se dibuja texto para mostrar 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 compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll