Fonction GetDC (winuser.h)

Article
08/27/2023

La fonction GetDC récupère un handle dans un contexte d’appareil (DC) pour la zone cliente d’une fenêtre spécifiée ou pour l’ensemble de l’écran. Vous pouvez utiliser le handle retourné dans les fonctions GDI suivantes pour dessiner dans le contrôleur de domaine. Le contexte de l’appareil est une structure de données opaque, dont les valeurs sont utilisées en interne par GDI.

La fonction GetDCEx est une extension de GetDC, qui permet à une application de mieux contrôler la façon dont et si le découpage se produit dans la zone cliente.

Syntaxe

HDC GetDC(
  [in] HWND hWnd
);

Paramètres

[in] hWnd

Handle de la fenêtre dont le contrôleur de domaine doit être récupéré. Si cette valeur est NULL, GetDC récupère le contrôleur de domaine pour l’ensemble de l’écran.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle du contrôleur de domaine pour la zone cliente de la fenêtre spécifiée.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

La fonction GetDC récupère un contrôleur de domaine commun, de classe ou privé en fonction du style de classe de la fenêtre spécifiée. Pour les contrôleurs de domaine de classe et privés, GetDC laisse les attributs précédemment affectés inchangés. Toutefois, pour les contrôleurs de domaine courants, GetDC affecte des attributs par défaut au contrôleur de domaine chaque fois qu’il est récupéré. Par exemple, la police par défaut est System, qui est une police bitmap. Pour cette raison, le handle d’un contrôleur de domaine commun retourné par GetDC ne vous indique pas quelle police, couleur ou pinceau a été utilisé lorsque la fenêtre a été dessinée. Pour déterminer la police, appelez GetTextFace.

Notez que le handle du contrôleur de domaine ne peut être utilisé que par un seul thread à la fois.

Après avoir peint avec un contrôleur de domaine commun, la fonction ReleaseDC doit être appelée pour libérer le contrôleur de domaine. Les contrôleurs de domaine de classe et privés n’ont pas besoin d’être libérés. ReleaseDC doit être appelé à partir du thread qui a appelé GetDC. Le nombre de contrôleurs de domaine est limité uniquement par la mémoire disponible.

Exemples

Pour obtenir un exemple, consultez Dessin avec la souris.

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