Graphics：：SetTextRenderingHint 方法 (gdiplusgraphics.h)

项目
08/24/2023

Graphics：：SetTextRenderingHint 方法设置此 Graphics 对象的文本呈现模式。

语法

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

parameters

[in] newMode

类型： TextRenderingHint

TextRenderingHint 枚举的元素，指定此 Graphics 对象当前用于呈现文本的过程。

返回值

类型：状态

如果该方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

TextRenderingHintClearTypeGridFit 仅在 Windows XP 和 Windows Server 2003 上受支持。

不能将 TextRenderingHintClearTypeGridFit 与 CompositingModeSourceCopy 一起使用。

示例

以下示例将文本呈现提示设置为两个不同的值，并绘制文本以演示每个值。

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

要求


最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdiplusgraphics.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll