Compartir a través de


COleControl::GetDC

Proporciona un objeto sin ventana para obtener un contexto de dispositivo de pantalla (o compatibles) de su contenedor.

CDC* GetDC( 
   LPCRECT lprcRect = NULL,
   DWORD dwFlags = OLEDC_PAINTBKGND  
);

Parámetros

  • lprcRect
    Un puntero al rectángulo que el control sin ventana desea actualizar, en coordenadas del cliente del control. NULL significa la extensión completa del objeto.

  • dwFlags
    Atributos del gráfico de contexto de dispositivo. Las opciones son:

    • OLEDC_NODRAW Indica que el objeto no usará el contexto para realizar gráfico pero para obtener simplemente la información del dispositivo de pantalla. El contenedor debe pasar simplemente DC de la ventana sin procesar la instrucción.

    • Las solicitudes deOLEDC_PAINTBKGND que el contenedor pintar el fondo antes de devolver elementos TITLE. Un objeto debe utilizar este marcador si está solicitando una TITLE. para optimizar un área con fondo transparente.

    • OLEDC_OFFSCREEN Informs el contenedor que el objeto desea mostrar en un mapa de bits fuera de la pantalla que se debe copiar en la pantalla. Un objeto debe utilizar este marcador cuando la operación de dibujo que está a punto de realizar genera mucho parpadeo. El contenedor es libre de honrar esta solicitud o no. Sin embargo, si este marcador no se establece, el contenedor debe de nuevo la mano una TITLE. en pantalla. Esto permite que los objetos realizan operaciones directas de presentación como mostrar una selección (mediante una operación de XOR ).

Valor devuelto

Puntero al contexto del dispositivo de pantalla para el área de cliente de CWnd de contenedor si correctamente; si no, el valor devuelto es NULL. El contexto del dispositivo de pantalla se puede utilizar en funciones subsiguientes de GDI para dibujar en el área de cliente de la ventana contenedora.

Comentarios

La función miembro de ReleaseDC se debe llamar a para liberar el contexto después de pintar. Al llamar a GetDC, paso de objetos el rectángulo que desean para dibujar en sus propias coordenadas de cliente. GetDC convierte estos en las coordenadas del área de cliente del contenedor. El objeto no debe solicitar un rectángulo de dibujo deseado más grande que su propio rectángulo del área de cliente, el tamaño cuyo puede recuperar con GetClientRect. Esto impide que los objetos dibujan inadvertidamente a donde no se supone.

Requisitos

encabezado: afxctl.h

Vea también

Referencia

COleControl Class

Gráfico de jerarquías

COleControl::ReleaseDC