BeginPaint, fonction (winuser.h)

Article
03/09/2024

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 à la fenêtre à repeindre.

[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 d’un contexte d’appareil d’affichage pour la fenêtre spécifiée.

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

Remarques

La fonction BeginPaint définit automatiquement la zone de découpage du contexte de l’appareil pour exclure toute 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 affectant 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 empêcher son effacement.

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 revenir.

Virtualisation PPP

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

Exemples

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

Configuration requise

Condition requise	Valeur
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)