Функция GetWindowDC

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

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

Синтаксис

HDC GetWindowDC(
  HWND hWnd   // дескриптор окна
);

Параметры

hWnd

[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

Размещение и совместимость GetWindowDC

К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да версии 3.1 и выше
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да версии 3.1 и выше
е
р
Используемая библиотека User32.lib
Используемая DLL -
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz