Fonction DrawCaption (winuser.h)

La fonction DrawCaption dessine une légende de fenêtre.

Syntaxe

BOOL DrawCaption(
  [in] HWND       hwnd,
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

[in] hwnd

Handle vers une fenêtre qui fournit du texte et une icône pour la fenêtre légende.

[in] hdc

Handle d'un contexte de périphérique. La fonction dessine la fenêtre légende dans ce contexte d’appareil.

[in] lprect

Pointeur vers une structure RECT qui spécifie le rectangle englobant pour la fenêtre légende en coordonnées logiques.

[in] flags

Options de dessin. Ce paramètre peut être égal à zéro ou plusieurs des valeurs suivantes.

Valeur	Signification
DC_ACTIVE	La fonction utilise les couleurs qui désignent un légende actif.
DC_BUTTONS	Si elle est définie, la fonction dessine les boutons dans la barre de légende (pour réduire, restaurer ou fermer une application).
DC_GRADIENT	Lorsque cet indicateur est défini, la fonction utilise COLOR_GRADIENTACTIVECAPTION (si l’indicateur DC_ACTIVE a été défini) ou COLOR_GRADIENTINACTIVECAPTION pour la couleur de la barre de titre. Si cet indicateur n’est pas défini, la fonction utilise COLOR_ACTIVECAPTION ou COLOR_INACTIVECAPTION pour les deux couleurs.
DC_ICON	La fonction dessine l’icône lors du dessin du texte légende.
DC_INBUTTON	La fonction dessine le légende sous forme de bouton.
DC_SMALLCAP	La fonction dessine un petit légende, à l’aide de la police de petite légende actuelle.
DC_TEXT	La fonction dessine le texte légende lors du dessin du légende.

Si DC_SMALLCAP est spécifié, la fonction dessine un légende de fenêtre normal.

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.


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