GetWindowDC, fonction (winuser.h)

Article
08/27/2023

La fonction GetWindowDC récupère le contexte de l’appareil (DC) pour l’ensemble de la fenêtre, y compris la barre de titre, les menus et les barres de défilement. Un contexte d’appareil de fenêtre permet de peindre n’importe où dans une fenêtre, car l’origine du contexte de l’appareil est le coin supérieur gauche de la fenêtre au lieu de la zone cliente.

GetWindowDC affecte des attributs par défaut au contexte de l’appareil de fenêtre chaque fois qu’il récupère le contexte de l’appareil. Les attributs précédents sont perdus.

Syntaxe

HDC GetWindowDC(
  [in] HWND hWnd
);

Paramètres

[in] hWnd

Handle de la fenêtre avec un contexte d’appareil qui doit être récupéré. Si cette valeur est NULL, GetWindowDC récupère le contexte de l’appareil pour l’écran entier.

Si ce paramètre a la valeur NULL, GetWindowDC récupère le contexte de l’appareil pour le moniteur d’affichage principal. Pour obtenir le contexte de l’appareil pour d’autres moniteurs d’affichage, utilisez les fonctions EnumDisplayMonitors et CreateDC .

Valeur retournée

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

Si la fonction échoue, la valeur de retour est NULL, ce qui indique une erreur ou un paramètre hWnd non valide.

Remarques

GetWindowDC est destiné aux effets de peinture spéciaux dans la zone non cliente d’une fenêtre. La peinture dans les zones non clientes d’une fenêtre n’est pas recommandée.

La fonction GetSystemMetrics peut être utilisée pour récupérer les dimensions de différentes parties de la zone non cliente, telles que la barre de titre, le menu et les barres de défilement.

La fonction GetDC peut être utilisée pour récupérer un contexte d’appareil pour l’ensemble de l’écran.

Une fois la peinture terminée, la fonction ReleaseDC doit être appelée pour libérer le contexte de l’appareil. Le fait de ne pas libérer le contexte de l’appareil de fenêtre a de graves effets sur la peinture demandée par les applications.

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)