Поделиться через


Метод Graphics::SetTextRenderingHint (gdiplusgraphics.h)

Метод Graphics::SetTextRenderingHint задает режим отрисовки текста этого объекта Graphics .

Синтаксис

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

Параметры

[in] newMode

Тип: TextRenderingHint

Элемент перечисления TextRenderingHint , указывающий процесс, используемый в данный момент объектом Graphics для отрисовки текста.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления 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
Header gdiplusgraphics.h (включая Gdiplus.h)
Библиотека Gdiplus.lib
DLL Gdiplus.dll

См. также раздел

Сглаживание с помощью текста

CompositingMode

Графика

Graphics::GetTextRenderingHint

Graphics::SetCompositingMode

TextRenderingHint