Fonction DrawFrameControl (winuser.h)

  • Article

La fonction DrawFrameControl dessine un contrôle frame du type et du style spécifiés.

Syntaxe

BOOL DrawFrameControl(
  [in] HDC    hdc,
  [in] LPRECT lprc,
  [in] UINT   uType,
  [in] UINT   uState
);

Paramètres

[in] hdc

Handle du contexte d’appareil de la fenêtre dans laquelle dessiner le contrôle.

[in] lprc

Pointeur vers une structure RECT qui contient les coordonnées logiques du rectangle englobant pour le contrôle frame.

[in] uType

Type de contrôle frame à dessiner. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
DFC_BUTTON
 Bouton Standard
DFC_CAPTION
 Barre de titre
DFC_MENU
 Barre de menus
DFC_POPUPMENU
 Élément de menu contextuel.
DFC_SCROLL
 Scroll bar

[in] uState

État initial du contrôle frame. Si uType est DFC_BUTTON, uState peut être l’une des valeurs suivantes.

Valeur Signification
DFCS_BUTTON3STATE
 Bouton à trois états
DFCS_BUTTONCHECK
 Case à cocher
DFCS_BUTTONPUSH
 Bouton-poussoir
DFCS_BUTTONRADIO
 Radio button
DFCS_BUTTONRADIOIMAGE
 Image pour la case d’option (nonsquare nécessite une image)
DFCS_BUTTONRADIOMASK
 Masque pour la case d’option (nonsquare a besoin de masque)
 

Si uType est DFC_CAPTION, uState peut être l’une des valeurs suivantes.

Valeur Signification
DFCS_CAPTIONCLOSE
 Bouton Fermer
DFCS_CAPTIONHELP
 Bouton Aide
DFCS_CAPTIONMAX
 Bouton Agrandir
DFCS_CAPTIONMIN
 Bouton Réduire
DFCS_CAPTIONRESTORE
 Bouton Restaurer
 

Si uType est DFC_MENU, uState peut avoir l’une des valeurs suivantes.

Valeur Signification
DFCS_MENUARROW
 Flèche de sous-menu
DFCS_MENUARROWRIGHT
 Flèche de sous-menu pointant vers la gauche. Ceci est utilisé pour les menus en cascade de droite à gauche utilisés avec des langues de droite à gauche telles que l’arabe ou l’hébreu.
DFCS_MENUBULLET
 Balle
DFCS_MENUCHECK
 Coche
 

Si uType est DFC_SCROLL, uState peut être l’une des valeurs suivantes.

Valeur Signification
DFCS_SCROLLCOMBOBOX
 Barre de défilement de zone de liste déroulante
DFCS_SCROLLDOWN
 Flèche vers le bas de la barre de défilement
DFCS_SCROLLLEFT
 Flèche gauche de la barre de défilement
DFCS_SCROLLRIGHT
 Flèche droite de la barre de défilement
DFCS_SCROLLSIZEGRIP
 Poignée de taille dans le coin inférieur droit de la fenêtre
DFCS_SCROLLSIZEGRIPRIGHT
 Poignée de taille dans le coin inférieur gauche de la fenêtre. Il est utilisé avec les langues de droite à gauche telles que l’arabe ou l’hébreu.
DFCS_SCROLLUP
 Flèche vers le haut de la barre de défilement
 

Le style suivant peut être utilisé pour ajuster le rectangle englobant du bouton poussage.

Valeur Signification
DFCS_ADJUSTRECT
 Le rectangle englobant est ajusté pour exclure le bord environnant du bouton poussoir.
 

Une ou plusieurs des valeurs suivantes peuvent être utilisées pour définir l’état du contrôle à dessiner.

Valeur Signification
DFCS_CHECKED
 Le bouton est activé.
DFCS_FLAT
 Le bouton a une bordure plate.
DFCS_HOT
 Le bouton est suivi à chaud.
DFCS_INACTIVE
 Le bouton est inactif (grisé).
DFCS_MONO
 Le bouton a une bordure monochrome.
DFCS_PUSHED
 Le bouton est enfoncé.
DFCS_TRANSPARENT
 L’arrière-plan reste intact. Cet indicateur ne peut être combiné qu’avec DFCS_MENUARROWUP ou DFCS_MENUARROWDOWN.

Valeur retournée

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.

Remarques

Si uType est DFC_MENU ou DFC_BUTTON et que uState n’est pas DFCS_BUTTONPUSH, le contrôle frame est un masque noir sur blanc (autrement dit, un contrôle d’image noir sur un arrière-plan blanc). Dans ce cas, l’application doit passer un handle à un contrôle de périphérique de mémoire bitmap. L’application peut ensuite utiliser l’image bitmap associée en tant que paramètre hbmMask pour la fonction MaskBlt , ou utiliser le contexte de l’appareil comme paramètre de la fonction BitBlt à l’aide de ROP telles que SRCAND et SRCINVERT.

Virtualisation DPI

Cette API ne participe pas à la virtualisation DPI. L’entrée donnée est toujours en termes de pixels physiques et n’est pas liée au contexte appelant.

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-2 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

RECT