CW&nd::GetDCExnbsp;

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

Valor devuelto

El contexto de dispositivo de la ventana especificada si la función es correcta; caso contrario NULL.

Parámetros

prgnClip

Identifica una región de recorte puede combinarse con la región visible de la ventana del cliente.

banderas

Puede tener uno de los siguientes valores preestablecidos:

• DCX_CACHEnbsp;  Devuelve un contexto de dispositivo de la memoria caché en lugar de la ventana de OW&NDC o CLASSDC . Reemplaza CS_OWNDC y CS_CLASSDC.
  
  
• DCX_CLIPCHILDRE&Nnbsp;  Excluye las regiones visibles de todas las ventanas del niño debajo de la ventana de CWnd.
  
  
• DCX_CLIPSIBLI&NGSnbsp;  Excluye las regiones visibles de todas las ventanas del mismo nivel por encima de la ventana de CWnd.
  
  
• DCX_EXCLUDERG&Nnbsp;  Excluye de la región de recorte identificada por prgnClip de la región visible del contexto de dispositivo devuelto.
  
  
• DCX_I&NTERSECTRGNnbsp;  Se cruza la región de recorte identificada por prgnClip dentro de la región visible del contexto de dispositivo devuelto.
  
  
• DCX_LOCKWI&NDOWUPDATEnbsp;  Permite dibujar incluso si hay un LockWindowUpdate en efecto llamada que excluiría de lo contrario esta ventana. Este valor se utiliza para el dibujo durante el seguimiento.
  
  
• DCX_PARE&NTCLIPnbsp;  Utiliza la región visible de la ventana principal y omite los bits de estilo WS_CLIPCHILDREN y WS_PARENTDC de la ventana principal. Este valor define el origen del contexto de dispositivo en la esquina superior izquierda de la ventana de CWnd.
  
  
• DCX_WI&NDOWnbsp;  Devuelve un contexto de dispositivo que corresponde para el rectángulo de la ventana en lugar de utilizar el rectángulo cliente.

Observaciones

Recupera el identificador de un contexto de dispositivo para la ventana de CWnd . El contexto de dispositivo puede utilizarse en posteriores funciones GDI para dibujar en el área de cliente.

Esta función, que es una extensión para el GetDC función, da como resultado una aplicación más control sobre cómo y si se recorta un contexto de dispositivo para una ventana.

A menos que el contexto de dispositivo pertenece a una clase de ventana, la ReleaseDC función debe llamarse para liberar el contexto después de dibujo. Ya sólo cinco contextos de dispositivo común están disponibles en cualquier momento dado, fracaso para liberar a un contexto de dispositivo puede impedir que otras aplicaciones tengan acceso a un contexto de dispositivo.

A fin de obtener un contexto de dispositivo en memoria caché, debe especificar una aplicación DCX_CACHE. Si no se especifica DCX_CACHE y la ventana es ni CS_OWNDC ni CS_CLASSDC, esta función devuelve NULL.

Un contexto de dispositivo con características especiales es devuelto por el GetDCEx funcionar si la CS_CLASSDC, CS_OWNDC, o CS_PARENTDC estilo se especificó en la estructura WNDCLASS cuando se registró la clase.

Para obtener más información acerca de estas características, vea la descripción de la estructura WNDCLASS en la documentación del SDK de Win32.

Visión General de CWnd |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CWnd::BeginPaint, CWnd::GetDC, CWnd::GetWindowDC, CWnd::ReleaseDC, :: GetDCEx