CWnd::GetDCEx

Artikel
02/26/2013

Ruft das Handle eines Gerätekontexts für das CWnd Fenster ab.

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

Parameter

prgnClip
Identifiziert ein Clippingbereich, der möglicherweise mit dem sichtbaren Bereich des Clientfensters kombiniert wird.
flags
Kann einen der folgenden Werte besitzen: voreingestellten
- DCX_CACHE gibt einen Gerätekontext aus dem Cache anstelle des OWNDC oder CLASSDC Fenster zurück.Überschreibungen CS_OWNDC und CS_CLASSDC.
- DCX_CLIPCHILDREN schließt die sichtbaren Bereiche aller untergeordneten Fenster unter dem CWnd Fenster aus.
- DCX_CLIPSIBLINGS schließt die sichtbaren Bereiche aller nebengeordnete Fenster über dem CWnd Fenster aus.
- DCX_EXCLUDERGN schließt den Auswahlbereich aus, der von prgnClip vom sichtbaren Bereich des zurückgegebenen Gerätekontexts identifiziert wird.
- DCX_INTERSECTRGN schneidet Clippingbereich, der von prgnClip innerhalb des sichtbaren Bereichs des zurückgegebenen Gerätekontexts identifiziert wird.
- DCX_LOCKWINDOWUPDATE ermöglicht Zeichnungen, selbst wenn ein LockWindowUpdate Aufruf wirksam gibt, der andernfalls dieses Fenster ausschließen würde.Dieser Wert wird zum Zeichnen während der Nachverfolgung verwendet.
- DCX_PARENTCLIP verwendet den sichtbaren Bereich des übergeordneten Fensters und ignoriert WS_CLIPCHILDREN und WS_PARENTDC Stilbite des übergeordneten Fensters.Dieser Wert wird der Ursprung des Gerätekontexts zur linken oberen Ecke des Fensters CWnd fest.
- DCX_WINDOW gibt einen Gerätekontext, der dem Fensterrechteck nicht entspricht, als das Clientrechteck zurück.

Rückgabewert

Der Gerätekontext für das angegebene Fenster, wenn die Funktion erfolgreich; andernfalls NULL.

Hinweise

Der Gerätekontext kann in folgenden GDI-Funktionen zum Sie umbrochenen im Clientbereich verwendet werden.

Diese Funktion, die eine Erweiterung der GetDC-Funktion ist, gibt eine Anwendung mehr Kontrolle über wie und ob ein Gerätekontext für ein Fenster abgeschnitten wird.

Es sei denn, der Gerätekontext einer Fensterklasse gehört, muss die ReleaseDC-Funktion aufgerufen werden, um den Kontext freizugeben, nachdem gezeichnet hat.Da nur fünf allgemeine Gerätekontexte zu einem beliebigen Zeitpunkt verfügbar sind, kann kann, einen Gerätekontext freizugeben andere Anwendungen am erlangt zu einem Gerätekontext verhindern.

Sie können ein zwischengespeicherter Gerätekontext, muss eine Anwendung DCX_CACHE angeben.Wenn DCX_CACHE nicht angegeben wird und das Fenster CS_OWNDC weder noch CS_CLASSDC ist, gibt NULL dieser Funktion.

Ein Gerätekontext mit besonderen Eigenschaften wird durch die GetDCEx-Funktion zurückgegeben, wenn das CS_CLASSDC, CS_OWNDC oder CS_PARENTDC Format in der WNDCLASS-Struktur angegeben wurde, als die Klasse registriert wurde.

Weitere Informationen über diese Eigenschaften, finden Sie in der Beschreibung der WNDCLASS-Struktur in Windows SDK.