Graphics::SetTextRenderingHint 메서드(gdiplusgraphics.h)

아티클
08/24/2023

Graphics::SetTextRenderingHint 메서드는 이 Graphics 개체의 텍스트 렌더링 모드를 설정합니다.

구문

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

매개 변수

[in] newMode

형식: TextRenderingHint

이 Graphics 개체가 텍스트를 렌더링하는 데 현재 사용하는 프로세스를 지정하는 TextRenderingHint 열거형의 요소입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

TextRenderingHintClearTypeGridFit 은 Windows XP 및 Windows Server 2003에서만 지원됩니다.

CompositingModeSourceCopy와 함께 TextRenderingHintClearTypeGridFit 을 사용할 수 없습니다.

예제

다음 예제에서는 텍스트 렌더링 힌트를 서로 다른 두 값으로 설정하고 각 값을 보여 주는 텍스트를 그립니다.

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 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll