Funzione BeginPaint (winuser.h)
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) |