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 |