Graphics::SetTextRenderingHint-Methode (gdiplusgraphics.h)

Artikel
08/24/2023

Die Graphics::SetTextRenderingHint-Methode legt den Textrenderingmodus dieses Graphics-Objekts fest.

Syntax

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

Parameter

[in] newMode

Typ: TextRenderingHint

Element der TextRenderingHint-Enumeration , die den Prozess angibt, der derzeit von diesem Graphics-Objekt zum Rendern von Text verwendet wird.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

TextRenderingHintClearTypeGridFit wird nur unter Windows XP und Windows Server 2003 unterstützt.

Sie können TextRenderingHintClearTypeGridFit nicht zusammen mit CompositingModeSourceCopy verwenden.

Beispiele

Im folgenden Beispiel wird der Textrenderinghinweis auf zwei unterschiedliche Werte festgelegt, und es wird Text zur Veranschaulichung der einzelnen Werte erstellt.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll