CWnd::GetDCEx
Получает дескриптор контекста устройства для окна CWnd.
CDC* GetDCEx(
CRgn* prgnClip,
DWORD flags
);
Параметры
prgnClip
Задает вырезанную область, которая может быть совмещена с регионом видимым в окне клиента.flags
Может иметь одно из следующих указанных значений:DCX_CACHE Возвращает контекст устройства из кэша вместо окно OWNDC или CLASSDC. Переопределяет CS_OWNDC и CS_CLASSDC.
DCX_CLIPCHILDREN Исключает видимые регионы всех дочерних окон под окном CWnd.
DCX_CLIPSIBLINGS Исключает видимые регионы всех окон одноуровневого для окна CWnd.
DCX_EXCLUDERGN Исключает вырезанную область, указанную prgnClip пределы видимой области, возвращенного из контекста устройства.
DCX_INTERSECTRGN Пересекает вырезанную область, указанную prgnClip в видимой области, возвращенного контекста устройства.
DCX_LOCKWINDOWUPDATE Позволяет документу, даже если вызов LockWindowUpdate включен, в противном случае исключил бы это окно. Это значение используется для рисования во время отслеживания.
DCX_PARENTCLIP Использует видимой области родительского окна и игнорирует все биты WS_CLIPCHILDREN родительского окна и стиля WS_PARENTDC. Это значение задает начало координат контекста устройства к верхнему верхн- левой стороны окна CWnd.
DCX_WINDOW Возвращает контекст устройства, соответствующий этому прямоугольнику окна, а не прямоугольник клиента.
Возвращаемое значение
Контекст устройства для заданного окна если функция успешно; в противном случае NULL.
Заметки
Контекст устройства могут использоваться в последующих функциях GDI для рисования в клиентской области.
Эта функция, которая является расширением функции GetDC предоставляет приложению более элемента управления закреплен за, как и ли контекст устройства для окна.
Если контекст устройства не будет принадлежать к классу окна, функция ReleaseDC должен быть вызван для освобождения контекст после рисования. Поскольку только 5 общих контекстов устройства доступны в любой момент времени сбой освобождение контекста устройства может помешать другие приложения от получения доступа к контексту устройства.
Для получения кэшированного значения контекста устройства, приложение должно определить DCX_CACHE. Если не указано ни DCX_CACHE и окно CS_OWNDC ни CS_CLASSDC, передачи NULL этой функции.
Контекст устройства со специальными характеристиками возвращаемый функцией GetDCEx если CS_CLASSDC, стиль CS_OWNDC или CS_PARENTDC были определены в структуре, то WNDCLASS если класс был зарегистрирован.
Дополнительные сведения об этих характеристик см. в описании структуры WNDCLASS в Windows SDK.
Требования
Header: afxwin.h