Функция GetDC (winuser.h)

Статья
08/27/2023

Функция GetDC извлекает дескриптор контекста устройства (DC) для клиентской области указанного окна или всего экрана. Возвращаемый дескриптор можно использовать в последующих функциях GDI для рисования в контроллере домена. Контекст устройства — это непрозрачная структура данных, значения которой используются внутри GDI.

Функция GetDCEx является расширением GetDC, которое дает приложению больший контроль над тем, как и происходит ли обрезка в клиентской области.

Синтаксис

HDC GetDC(
  [in] HWND hWnd
);

Параметры

[in] hWnd

Дескриптор для окна, контроллер домена которого требуется извлечь. Если это значение равно NULL, GetDC извлекает контроллер домена для всего экрана.

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

Если функция выполняется успешно, возвращаемое значение является дескриптором контроллера домена для клиентской области указанного окна.

Если функция завершается сбоем, возвращается значение NULL.

Функция GetDC извлекает общий, класс или частный контроллер домена в зависимости от стиля класса указанного окна. Для контроллеров домена класса и частных контроллеров домена GetDC оставляет ранее назначенные атрибуты без изменений. Однако для распространенных контроллеров домена GetDC назначает атрибуты по умолчанию контроллеру домена при каждом извлечении. Например, шрифт по умолчанию — System, который представляет собой точечный шрифт. По этой причине дескриптор общего контроллера домена, возвращаемого GetDC , не сообщает, какой шрифт, цвет или кисть использовался при рисовании окна. Чтобы определить шрифт, вызовите Метод GetTextFace.

Обратите внимание, что дескриптор контроллера домена может использоваться только одним потоком в любой момент времени.

После рисования с помощью общего контроллера домена необходимо вызвать функцию ReleaseDC , чтобы освободить контроллер домена. Не нужно освобождать контроллеры домена класса и частные контроллеры домена. ReleaseDC должен вызываться из того же потока, что и GetDC. Количество контроллеров домена ограничено только доступной памятью.

Примеры

Пример см. в разделе Рисование с помощью мыши.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll