CWnd::GetDCEx

Artykuł
02/27/2013

Pobiera dojście kontekstu urządzenia do CWnd okna.

CDC* GetDCEx(
   CRgn* prgnClip,
   DWORD flags 
);

Parametry

prgnClip
Identyfikuje obszar przycinania, które mogą być łączone z region widoczny w oknie klienta.
flags
Może mieć jedną z następujących wartości predefiniowanych:
- DCX_CACHE zwraca kontekstu urządzenia z pamięci podręcznej a nie OWNDC lub CLASSDC okna.Zastępuje CS_OWNDC i CS_CLASSDC.
- DCX_CLIPCHILDREN wyklucza regiony widoczne wszystkie podrzędne okna CWnd okna.
- DCX_CLIPSIBLINGS wyklucza regiony widoczne wszystkie powyższe windows równorzędny CWnd okna.
- DCX_EXCLUDERGN nie obejmuje obszar przycinania identyfikowane przez prgnClip z regionu widoczne kontekstu urządzenia zwracane.
- DCX_INTERSECTRGN przecina obszar przycinania identyfikowane przez prgnClip w regionie widoczne kontekstu urządzenia zwracane.
- DCX_LOCKWINDOWUPDATE umożliwia rysunku, nawet jeśli jest LockWindowUpdate wywołania efektu, który w przeciwnym razie można wyłączyć to okno.Ta wartość jest używana dla rysunku podczas śledzenia.
- DCX_PARENTCLIP używa region widoczny okno nadrzędne i pomija okno nadrzędne WS_CLIPCHILDREN i WS_PARENTDC styl bitów.Ta wartość ustawia pochodzenia kontekstu urządzenia do lewego górnego rogu CWnd okna.
- DCX_WINDOW zwraca kontekstu urządzenia, który odpowiada prostokąt okna niż prostokąt klienta.

Wartość zwracana

Kontekstu urządzenia dla określonego okna, jeśli funkcja jest pomyślne; w przeciwnym razie NULL.

Uwagi

Kontekstu urządzenia można w kolejne funkcje interfejsu GDI do rysowania w obszarze klienckim.

Ta funkcja, która jest rozszerzeniem do GetDC działały, daje większą kontrolę nad jak i czy jest przycięty kontekstu urządzenia okna aplikacji.

Chyba że kontekstu urządzenia należy do klasy okna, ReleaseDC musi zostać wywołana funkcja zwolnić kontekście po rysunku.Ponieważ tylko pięć wspólnej kontekstów urządzeń są dostępne w danym momencie, awarii zwolnienie kontekstu urządzenia można zapobiec inne aplikacje, uzyskanie dostępu do kontekstu urządzenia.

Uzyskanie kontekstu urządzenia buforowanych aplikacji należy określić DCX_CACHE.Jeśli DCX_CACHE nie jest określony i okna nie jest ani CS_OWNDC ani CS_CLASSDC, funkcja zwraca NULL.

Kontekstu urządzenia o specjalnych cechach jest zwracany przez GetDCEx działać, jeśli CS_CLASSDC, CS_OWNDC, lub CS_PARENTDC styl został określony w WNDCLASS struktury, gdy klasa została zarejestrowana.

Aby uzyskać więcej informacji na temat tych cech, zobacz opis WNDCLASS struktury w Windows SDK.