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


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

См. также

Ссылки

Класс CWnd

Диаграмма иерархии

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx