Метод IFont::SetHdc (ocidl.h)

Статья
08/25/2023

Предоставляет контекст устройства для шрифта, описывающего режим логического сопоставления.

Синтаксис

HRESULT SetHdc(
  [in] HDC hDC
);

Параметры

[in] hDC

Дескриптор контекста устройства, в котором выбирается шрифт.

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

Метод поддерживает стандартное возвращаемое значение E_INVALIDARG, а также следующие значения.

Код возврата	Описание
S_OK	Шрифт успешно выбран.
E_NOTIMPL	Выбор шрифта в этом объекте шрифта не поддерживается.

Режим логического сопоставления влияет на внутреннее вычисление шрифта его размера точек, поэтому, когда вызывающий объект запрашивает дескриптор шрифта путем вызова IFont::get_hFont, шрифт уже правильно масштабируется в контексте устройства.

Примечания к вызывающим абонентам

Вызывающий объект сохраняет право собственности на этот контекст устройства, который должен оставаться действительным в течение времени существования объекта шрифта. Таким образом, передаваемый контекст устройства должен быть контекстом устройства памяти (из функции CreateCompatibleDC), а не контекстом устройства с экрана (из CreateDC, GetDC или BeginPaint), так как контексты устройства с экрана являются ограниченным системным ресурсом.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ocidl.h

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

IFont

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