Función GetDC (winuser.h)

La función GetDC recupera un identificador para un contexto de dispositivo (DC) para el área cliente de una ventana especificada o para toda la pantalla. Puede usar el identificador devuelto en las funciones GDI posteriores para dibujar en el controlador de dominio. El contexto del dispositivo es una estructura de datos opaca, cuyos valores usan internamente GDI.

La función GetDCEx es una extensión para GetDC, que proporciona a una aplicación más control sobre cómo y si se produce el recorte en el área cliente.

Sintaxis

HDC GetDC(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Identificador de la ventana cuyo controlador de dominio se va a recuperar. Si este valor es NULL, GetDC recupera el controlador de dominio para toda la pantalla.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el controlador de dominio para el área de cliente de la ventana especificada.

Si se produce un error en la función, el valor devuelto es NULL.

Comentarios

La función GetDC recupera un controlador de dominio común, clase o privado en función del estilo de clase de la ventana especificada. Para los controladores de dominio privados y de clase, GetDC deja los atributos asignados previamente sin cambios. Sin embargo, para los controladores de dominio comunes, GetDC asigna atributos predeterminados al controlador de dominio cada vez que se recupera. Por ejemplo, la fuente predeterminada es System, que es una fuente de mapa de bits. Por este motivo, el identificador de un controlador de dominio común devuelto por GetDC no indica qué fuente, color o pincel se usó cuando se dibujó la ventana. Para determinar la fuente, llame a GetTextFace.

Tenga en cuenta que un único subproceso solo puede usar el identificador del controlador de dominio en cualquier momento.

Después de pintar con un controlador de dominio común, se debe llamar a la función ReleaseDC para liberar el controlador de dominio. Los controladores de dominio privados y de clase no tienen que liberarse. Se debe llamar a ReleaseDC desde el mismo subproceso que llamó a GetDC. El número de controladores de dominio solo está limitado por la memoria disponible.

Ejemplos

Para obtener un ejemplo, vea Dibujo con el mouse.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll

Consulte también

Funciones de contexto de dispositivo

Información general sobre contextos de dispositivo

GetDCEx

GetTextFace

GetWindowDC

ReleaseDC

WindowFromDC