Compartir a través de


CWnd::GetDCEx

Recupera el identificador de un contexto para la ventana de CWnd .

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

Parámetros

  • prgnClip
    Identifica una zona de recorte que se puede combinar con el área visible de la ventana del cliente.

  • flags
    Puede tener uno de los valores preestablecidos siguientes:

    • DCX_CACHE devuelve un contexto de dispositivo de caché en lugar de la ventana de OWNDC o de CLASSDC . Reemplaza CS_OWNDC y CS_CLASSDC.

    • DCX_CLIPCHILDREN Excludes áreas visibles de todas las ventanas secundarias debajo de la ventana de CWnd .

    • DCX_CLIPSIBLINGS Excludes áreas visibles de todas las ventanas relacionadas sobre la ventana de CWnd .

    • DCX_EXCLUDERGN Excludes la zona de recorte identificada por prgnClip del área visible del contexto devuelto del dispositivo.

    • DCX_INTERSECTRGN corta la zona de recorte identificada por prgnClip dentro del área visible del contexto devuelto del dispositivo.

    • Gráfico deDCX_LOCKWINDOWUPDATE Allow incluso si hay una llamada de LockWindowUpdate en efecto que excluiría de otra manera esta ventana. Este valor se utiliza para dibujar durante el seguimiento.

    • DCX_PARENTCLIP utiliza el área visible de la ventana primaria y omite los bits de WS_CLIPCHILDREN y de WS_PARENTDC de la ventana primaria. Este valor establece el origen de contexto de dispositivo a la esquina superior izquierda de la ventana de CWnd .

    • DCX_WINDOW devuelve un contexto de dispositivo que corresponde al rectángulo de ventana en lugar del rectángulo de cliente.

Valor devuelto

El contexto para la ventana especificada si la función es correcta; si no NULL.

Comentarios

El contexto de dispositivo se puede utilizar en funciones subsiguientes de GDI para dibujar en el área cliente.

Esta función, que es una extensión a la función de GetDC , proporciona a aplicación más control sobre cómo y si un contexto para una ventana se recortarán.

A menos que el contexto de dispositivo pertenece a una clase de ventana, la función de ReleaseDC se debe llamar a para liberar el contexto después de dibujar. Como sólo cinco contextos comunes de dispositivos están disponibles en un momento dado, el error liberar un contexto del dispositivo puede evitar que otras aplicaciones obtener acceso a un contexto de dispositivo.

Para obtener un contexto almacenado en caché del dispositivo, una aplicación debe especificar DCX_CACHE. Si DCX_CACHE no se especifica y la ventana no CS_OWNDC ni CS_CLASSDC, esta función devuelve NULL.

Un contexto de dispositivos con características especiales es devuelto por la función de GetDCEx si el estilo de CS_CLASSDC, de CS_OWNDC, o de CS_PARENTDC se especificó en la estructura de Clase WNDCLASS cuando la clase se registrada.

Para obtener más información sobre estas características, vea la descripción de la estructura de Clase WNDCLASS en Windows SDK.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

CWnd (clase)

Gráfico de jerarquías

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx