Функция GetWindowDC

Функция GetWindowDC извлекает контекст устройства (DC) для всего окна, включая области заголовка, меню и полосы прокрутки. Контекст устройства окна разрешает красить в любом месте окна, потому что начало координат контекста устройства - левый верхний угол окна вместо рабочей области.

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

Синтаксис

Параметры

[in] Дескриптор окна с контекстом устройства, который должен извлечься. Если это значение равно NULL, GetWindowDC извлекает контекст устройства для всего экрана.

Windows 98/Me, Windows 2000/XP: Если этот параметр - NULL, то функция GetWindowDC извлекает контекст устройства для исходного экранного монитора. Чтобы получить контекст устройства для других экранных мониторов, используйте функции EnumDisplayMonitors и CreateDC.

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

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

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Функция GetWindowDC предназначается для специальных эффектов окрашивания внутри нерабочей области окна. Окрашивание в нерабочих областях любого окна не рекомендуется.

Функция GetSystemMetrics может быть использована, чтобы извлекать размеры различных частей нерабочей области, такой как область заголовка, меню и полосы прокрутки.

Функция GetDC может быть использована для извлечения контекста устройства для всего экрана.

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

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, BeginPaint, GetDC, GetSystemMetrics, ReleaseDC