CWnd::GetDCEx

Makale
02/26/2013

Bir aygıt içeriğini için tanıtıcı alır CWnd pencere.

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

Parametreler

prgnClip
İstemci penceresi görünür bölge ile birleştirilmiş bir kırpma bölgesini tanımlar.
flags
Hazır ayar aşağıdaki değerlerden biri olabilir:
- dcx_cache önbellekten bir aygıt içeriğini döndürür yerine owndc veya classdc pencere. Geçersiz kılar cs_owndc ve cs_classdc.
- DCX_CLIPCHILDREN aşağıdaki tüm alt pencereler görünür bölgeleri hariç CWnd pencere.
- DCX_CLIPSIBLINGS , yukarıdaki tüm kardeş Windows'un görünür bölgelerde dışlar CWnd pencere.
- dcx_excludergn tarafından tanımlanan kırpma bölgesini çıkarır prgnClip döndürülen aygıt içeriğinin görünür bölgesinden.
- DCX_INTERSECTRGN tarafından tanımlanan kırpma bölgesini kestiği prgnClip döndürülen aygıt içeriğinin görünür bölge içinde.
- DCX_LOCKWINDOWUPDATE olsa bile çizim sağlayan bir LockWindowUpdate , aksi takdirde bu pencere dışarıda etkin çağrı. Bu değer, çizim sırasında izleme için kullanılır.
- DCX_PARENTCLIP ana penceresinin görünür bölge kullanır ve ana pencerenin yoksayar WS_CLIPCHILDREN ve ws_parentdc stil biti. Bu değer sol üst köşedeki aygıt içeriğin kaynağını ayarlar CWnd pencere.
- DCX_WINDOW istemci dikdörtgen yerine Pencere dikdörtgeni karşılık gelen bir aygıt içeriğini döndürür.

Dönüş Değeri

İşlev başarılı olursa belirtilen pencere için aygıt içeriği; Aksi halde null.

Notlar

İstemci alanında çizmek için aygıt içeriği izleyen GDI işlevleri kullanılabilir.

Bir uzantısıdır bu işlev için GetDC işlev, bir uygulama olup olmadığını ve nasıl bir pencere için aygıt içeriği kırpılmış üzerinde daha fazla denetim sağlar.

Aygıt içeriğini bir pencere sınıfı için ait olduğu sürece ReleaseDC işlevinin çağrılmasını, sonra çizim içeriği serbest bırakmak. Yalnızca beş ortak aygıt içerikleri herhangi bir zamanda kullanılabilir olduğundan, başarısız bir aygıt içeriğini serbest bırakmak için diğer uygulamaların bir aygıt içeriğini erişmesini engelleyebilirsiniz.

Önbelleğe alınan aygıt içeriğini almak için bir uygulama belirtmelisiniz dcx_cache. dcx_cache belirtilmezse ve pencere ne cs_owndc , ne de cs_classdc, bu işlev verir null.

Özel özelliklere sahip bir aygıt içeriğini tarafından döndürülen GetDCEx , işlev cs_classdc, cs_owndc, ya da cs_parentdc stil belirtilen wndclass yapı sınıfı kaydolurken.

Bu özellikleri hakkında daha fazla bilgi için bkz: açıklama wndclass , yapı Windows SDK.