Compartir a través de


Función BeginPaint (winuser.h)

La función BeginPaint prepara la ventana especificada para pintar y rellena una estructura PAINTSTRUCT con información sobre la pintura.

Sintaxis

HDC BeginPaint(
  [in]  HWND          hWnd,
  [out] LPPAINTSTRUCT lpPaint
);

Parámetros

[in] hWnd

Identificador de la ventana que se va a volver a pintar.

[out] lpPaint

Puntero a la estructura PAINTSTRUCT que recibirá información de pintura.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es NULL, lo que indica que no hay ningún contexto de dispositivo para mostrar disponible.

Comentarios

La función BeginPaint establece automáticamente la región de recorte del contexto del dispositivo para excluir cualquier área fuera de la región de actualización. La función InvalidateRect o InvalidateRgn establece la región de actualización y el sistema después de cambiar el tamaño, mover, crear, desplazarse o cualquier otra operación que afecte al área cliente. Si la región de actualización está marcada para borrar, BeginPaint envía un mensaje de WM_ERASEBKGND a la ventana.

Una aplicación no debe llamar a BeginPaint excepto en respuesta a un mensaje de WM_PAINT . Cada llamada a BeginPaint debe tener una llamada correspondiente a la función EndPaint .

Si el símbolo de intercalación está en el área que se va a pintar, BeginPaint oculta automáticamente el símbolo de intercalación para evitar que se borre.

Si la clase de la ventana tiene un pincel de fondo, BeginPaint usa ese pincel para borrar el fondo de la región de actualización antes de devolverlo.

Virtualización de PPP

Esta API no participa en la virtualización de PPP. La salida devuelta siempre está en términos de píxeles físicos.

Ejemplos

Para obtener un ejemplo, vea Dibujo en el área cliente.

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)

Consulte también

EndPaint

InvalidateRect

InvalidateRgn

PAINTSTRUCT

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo

ValidateRect

ValidateRgn