BeginPaint, fonction (winuser.h)

Article
03/15/2023

La fonction BeginPaint prépare la fenêtre spécifiée pour la peinture et remplit une structure PAINTSTRUCT avec des informations sur la peinture.

Syntaxe

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

Paramètres

[in] hWnd

Handle to the window to be repainted.

[out] lpPaint

Pointeur vers la structure PAINTSTRUCT qui recevra des informations de peinture.

Valeur retournée

Si la fonction réussit, la valeur de retour est le handle vers un contexte d’appareil d’affichage pour la fenêtre spécifiée.

Si la fonction échoue, la valeur de retour est NULL, indiquant qu’aucun contexte d’appareil d’affichage n’est disponible.

Notes

La fonction BeginPaint définit automatiquement la région de découpage du contexte de l’appareil pour exclure n’importe quelle zone en dehors de la région de mise à jour. La région de mise à jour est définie par la fonction InvalidateRect ou InvalidateRgn et par le système après le dimensionnement, le déplacement, la création, le défilement ou toute autre opération qui affecte la zone cliente. Si la région de mise à jour est marquée pour l’effacement, BeginPaint envoie un message WM_ERASEBKGND à la fenêtre.

Une application ne doit pas appeler BeginPaint , sauf en réponse à un message WM_PAINT . Chaque appel à BeginPaint doit avoir un appel correspondant à la fonction EndPaint .

Si le caret se trouve dans la zone à peindre, BeginPaint masque automatiquement le caret pour l’empêcher d’être effacé.

Si la classe de la fenêtre a un pinceau d’arrière-plan, BeginPaint utilise ce pinceau pour effacer l’arrière-plan de la région de mise à jour avant de retourner.

Virtualisation DPI

Cette API ne participe pas à la virtualisation DPI. La sortie retournée est toujours en termes de pixels physiques.

Exemples

Pour obtenir un exemple, consultez Dessin dans la zone cliente.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-draw-l1-1-0 (introduit dans Windows 8)