Función GetDC (winuser.h)

Artículo
03/13/2024

La función GetDC recupera un identificador de un contexto de dispositivo (DC) para el área de 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 se usan internamente por GDI.

La función GetDCEx es una extensión de 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 realiza correctamente, el valor devuelto es un identificador del controlador de dominio para el área de cliente de la ventana especificada.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

La función GetDC recupera un controlador de dominio común, de clase o privado, según el estilo de clase de la ventana especificada. En el caso de los controladores de dominio privados y de clase, GetDC deja los atributos asignados previamente sin cambios. Sin embargo, para 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. No es necesario liberar controladores de dominio privados ni clases. Se debe llamar a ReleaseDC desde el mismo subproceso que llamó a GetDC. El número de controladores de dominio está limitado solo por la memoria disponible.

Ejemplos

Para obtener un ejemplo, vea Dibujo con el mouse.

Requisitos

Requisito	Value
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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll