Partager via


GetWindowDC, fonction (winuser.h)

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)

Voir aussi

BeginPaint

GetDC

GetSystemMetrics

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

ReleaseDC