Funzione BeginPaint (winuser.h)

Articolo
03/04/2024

La funzione BeginPaint prepara la finestra specificata per la pittura e riempie una struttura PAINTSTRUCT con informazioni sulla pittura.

Sintassi

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

Parametri

[in] hWnd

Handle nella finestra da riintedire.

[out] lpPaint

Puntatore alla struttura PAINTSTRUCT che riceverà informazioni di disegno.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle di un contesto del dispositivo visualizzato per la finestra specificata.

Se la funzione ha esito negativo, il valore restituito è NULL, che indica che non è disponibile alcun contesto del dispositivo visualizzato.

Commenti

La funzione BeginPaint imposta automaticamente l'area di ritaglio del contesto del dispositivo per escludere qualsiasi area all'esterno dell'area di aggiornamento. L'area di aggiornamento viene impostata dalla funzione InvalidateRect o InvalidateRgn e dal sistema dopo il ridimensionamento, lo spostamento, la creazione, lo scorrimento o qualsiasi altra operazione che influisce sull'area client. Se l'area di aggiornamento è contrassegnata per l'cancellazione, BeginPaint invia un messaggio di WM_ERASEBKGND alla finestra.

Un'applicazione non deve chiamare BeginPaint tranne in risposta a un messaggio di WM_PAINT . Ogni chiamata a BeginPaint deve avere una chiamata corrispondente alla funzione EndPaint .

Se il caret si trova nell'area da disegnare, BeginPaint nasconde automaticamente il caret per impedire che venga cancellato.

Se la classe della finestra ha un pennello di sfondo, BeginPaint usa tale pennello per cancellare lo sfondo dell'area di aggiornamento prima di restituire.

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. L'output restituito è sempre in termini di pixel fisici.

Esempio

Per un esempio, vedere Disegno nell'area client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-draw-l1-1-0 (introdotto in Windows 8)