Метод IPicture::get_CurDC (ocidl.h)

Статья
03/13/2024

Извлекает дескриптор текущего контекста устройства. Это свойство допустимо только для растровых рисунков.

Синтаксис

HRESULT get_CurDC(
  [out] HDC *phDC
);

Параметры

[out] phDC

Указатель на переменную, которая получает контекст устройства.

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

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

Код возврата	Описание
S_OK	Биты атрибутов были успешно возвращены.
E_POINTER	Недопустимое значение phDC . Например, он может иметь значение NULL.

Свойство CurDC и метод IPicture::SelectPicture существуют для обхода ограничений в Windows; В частности, объект может быть выбран только в одном контексте устройства одновременно. В некоторых случаях объект рисунка может быть окончательно выбран в определенном контексте устройства (например, элемент управления может использовать определенное изображение для фона). Чтобы использовать это свойство рисунка в другом месте, его необходимо временно отменить из старого контекста устройства, выбрать в новом контексте устройства для операции, а затем повторно выбрать обратно в старый контекст устройства. Метод IPicture::get_CurDC возвращает дескриптор контекста устройства, в котором в данный момент выбран рисунок. Метод IPicture::SelectPicture выбирает рисунок в новый контекст устройства, возвращая старый контекст устройства и дескриптор GDI рисунка. Вызывающий объект должен выбрать рисунок обратно в старый контекст устройства, когда вызывающий объект закончит работу с ним, как это обычно для кода Windows.

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

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

Требования

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

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

IPicture

IPicture::SelectPicture

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