Función GetWindowDC (winuser.h)

Artículo
03/04/2024

La función GetWindowDC recupera el contexto del dispositivo (DC) para toda la ventana, incluida la barra de título, los menús y las barras de desplazamiento. Un contexto de dispositivo de ventana permite pintar en cualquier parte de una ventana, ya que el origen del contexto del dispositivo es la esquina superior izquierda de la ventana en lugar del área de cliente.

GetWindowDC asigna atributos predeterminados al contexto del dispositivo de ventana cada vez que recupera el contexto del dispositivo. Los atributos anteriores se pierden.

Sintaxis

HDC GetWindowDC(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Identificador de la ventana con un contexto de dispositivo que se va a recuperar. Si este valor es NULL, GetWindowDC recupera el contexto del dispositivo para toda la pantalla.

Si este parámetro es NULL, GetWindowDC recupera el contexto del dispositivo para el monitor de presentación principal. Para obtener el contexto del dispositivo para otros monitores de pantalla, use las funciones EnumDisplayMonitors y CreateDC .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de un contexto de dispositivo para la ventana especificada.

Si se produce un error en la función, el valor devuelto es NULL, lo que indica un error o un parámetro hWnd no válido.

Comentarios

GetWindowDC está diseñado para efectos de pintura especiales dentro del área no cliente de una ventana. No se recomienda pintar en áreas no cliente de ninguna ventana.

La función GetSystemMetrics se puede usar para recuperar las dimensiones de varias partes del área no cliente, como la barra de título, el menú y las barras de desplazamiento.

La función GetDC se puede usar para recuperar un contexto de dispositivo para toda la pantalla.

Una vez completada la pintura, se debe llamar a la función ReleaseDC para liberar el contexto del dispositivo. No liberar el contexto del dispositivo de ventana tiene efectos graves en la pintura solicitada por las aplicaciones.

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
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-0 (introducido en Windows 8)