Metodo Graphics::SetTextRenderingHint (gdiplusgraphics.h)

Articolo
03/14/2023

Il metodo Graphics::SetTextRenderingHint imposta la modalità di rendering del testo di questo oggetto Graphics .

Sintassi

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

Parametri

[in] newMode

Tipo: TextRenderingHint

Elemento dell'enumerazione TextRenderingHint che specifica il processo attualmente utilizzato da questo oggetto Graphics per il rendering del testo.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

TextRenderingHintClearTypeGridFit è supportato solo in Windows XP e Windows Server 2003.

Non è possibile usare TextRenderingHintClearTypeGridFit insieme a CompositingModeSourceCopy.

Esempio

Nell'esempio seguente l'hint per il rendering del testo viene impostato su due valori diversi e viene disegnato il testo per illustrare ogni valore.

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

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll