CW&nd::GetDCExnbsp;

CDC * GetDCEx ( CRgn * PrgnClip, DWORD Flags );

Rückgabewert

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

Parameter

prgnClip

Identifiziert einen Ausschneidebereich, der mit den sichtbaren Bereich des Client-Fensters kombiniert werden kann.

flaggen

Kann eine der folgenden voreingestellten Werte haben:

• DCX_CACHE&Nbsp;  Gibt einen Gerätekontext aus dem Cache statt Fenster OWNDC oder CLASSDC . Überschreibt die CS_OWNDC und CS_CLASSDC.
  
  
• DCX_CLIPCHILDRE&NNbsp;  Schließt sichtbaren Regionen des alle untergeordneten Fenster unter dem CWnd -Fenster.
  
  
• DCX_CLIPSIBLI&NGSNbsp;  Schließt die sichtbaren Regionen alle nebengeordnete Fenster über dem CWnd -Fenster.
  
  
• DCX_EXCLUDERG&NNbsp;  Schließt den Ausschneidebereich identifiziert durch PrgnClip aus dem sichtbaren Bereich des zurückgegebenen Gerätekontext.
  
  
• DCX_I&NTERSECTRGNNbsp;  Schneidet den Ausschneidebereich identifiziert durch PrgnClip im sichtbaren Bereich der zurückgegebenen Gerätekontext.
  
  
• DCX_LOCKWI&NDOWUPDATENbsp;  Ermöglicht, dass die Zeichnung, auch wenn es eine LockWindowUpdate aufrufen in Kraft, die sonst in diesem Fenster ausschließen würde. Dieser Wert wird für die Zeichnung während der Nachverfolgung verwendet.
  
  
• DCX_PARE&NTCLIPNbsp;  Verwendet den sichtbaren Bereich des übergeordneten Fensters und des übergeordneten Fensters WS_CLIPCHILDREN und WS_PARENTDC Formatbits ignoriert. Dieser Wert setzt den Gerätekontext Ursprung in der oberen linken Ecke des Fensters CWnd.
  
  
• DCX_WI&NDOWNbsp;  Gibt einen Gerätekontext, der entspricht das Rechteck Fenster anstatt das Clientrechteck.

Bemerkungen

Ruft das Handle für einen Gerätekontext für das CWnd -Fenster. Der Gerätekontext kann in nachfolgenden GDI-Funktionen verwendet werden, um im Clientbereich zeichnen.

Diese Funktion, die eine Erweiterung um die GetDC -Funktion gibt einer Anwendung besser steuern, wie und ob ein Gerätekontext für ein Fenster abgeschnitten wird.

Es sei denn, der Gerätekontext eine Fensterklasse, gehört der ReleaseDC -Funktion aufgerufen werden, um nach Zeichnung Kontext freigeben. Da nur fünf gemeinsamen Gerätekontexte jederzeit verfügbar sind, können Fehler einen Gerätekontext freizugeben andere Anwendungen Zugriff auf einen Gerätekontext verhindern.

Um einen zwischengespeicherten Gerätekontext zu erhalten, muss eine Anwendung angeben DCX_CACHE. Wenn DCX_CACHE nicht angegeben wird und das Fenster weder CS_OWNDC ist noch CS_CLASSDC, diese Funktion gibt NULL zurück.

Ein Gerätekontext mit besonderen Eigenschaften von zurückgegeben wird die GetDCEx funktionieren, wenn die CS_CLASSDC, CS_OWNDC, oder CS_PARENTDC Stil wurde angegeben, der WNDCLASS Struktur, wenn die Klasse registriert wurde.

Weitere Informationen zu diesen Eigenschaften finden Sie unter die Beschreibung der WNDCLASS Struktur in der Win32 SDK-Dokumentation.

CWnd Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CWnd::BeginPaint, CWnd::GetDC, CWnd::GetWindowDC, CWnd::ReleaseDC, :: GetDCEx