Función GetWindowDC (winuser.h)

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

   
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)

Consulte también

BeginPaint

GetDC

GetSystemMetrics

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo

ReleaseDC