Freigeben über


Graphics::SetTextRenderingHint-Methode (gdiplusgraphics.h)

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

Weitere Informationen

Antialiasing mit Text

Compositingmode

Grafiken

Graphics::GetTextRenderingHint

Graphics::SetCompositingMode

Textrenderinghint