WM_GETDLGCODE message

Article
06/13/2023

Envoyé à la procédure de fenêtre associée à un contrôle. Par défaut, le système gère toutes les entrées du clavier dans le contrôle ; le système interprète certains types d’entrée au clavier comme des touches de navigation de boîte de dialogue. Pour remplacer ce comportement par défaut, le contrôle peut répondre au message WM_GETDLGCODE pour indiquer les types d’entrée qu’il souhaite traiter lui-même.

#define WM_GETDLGCODE                   0x0087

Paramètres

wParam: La touche virtuelle, enfoncée par l’utilisateur, qui a invité Windows à émettre cette notification. Le gestionnaire doit gérer ces clés de manière sélective. Par instance, le gestionnaire peut accepter et traiter VK_RETURN mais déléguer VK_TAB à la fenêtre propriétaire. Pour obtenir la liste des valeurs, consultez Codes de clé virtuelle.
lParam: Pointeur vers une structure MSG (ou NULL si le système exécute une requête).

Valeur retournée

La valeur de retour est une ou plusieurs des valeurs suivantes, indiquant le type d’entrée que l’application traite.

Code/valeur de retour	Description
DLGC_BUTTON 0x2000	Bouton.
DLGC_DEFPUSHBUTTON 0x0010	Bouton push par défaut.
DLGC_HASSETSEL 0x0008	EM_SETSEL messages.
DLGC_RADIOBUTTON 0x0040	Case d’option.
DLGC_STATIC 0x0100	Contrôle statique.
DLGC_UNDEFPUSHBUTTON 0x0020	Bouton push autre que la valeur par défaut.
DLGC_WANTALLKEYS 0x0004	Toutes les entrées du clavier.
DLGC_WANTARROWS 0x0001	Touches de direction.
DLGC_WANTCHARS 0x0080	WM_CHAR messages.
DLGC_WANTMESSAGE 0x0004	Toutes les entrées du clavier (l’application transmet ce message dans la structure MSG au contrôle).
DLGC_WANTTAB 0x0002	Touche TAB.

Notes

Bien que la fonction DefWindowProc retourne toujours zéro en réponse au message WM_GETDLGCODE , la procédure de fenêtre pour les classes de contrôle prédéfinies retourne un code approprié pour chaque classe.

Le WM_GETDLGCODE message et les valeurs retournées sont utiles uniquement avec les contrôles de boîte de dialogue définis par l’utilisateur ou les contrôles standard modifiés par la sous-classe.

Spécifications

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]
En-tête	Winuser.h (inclure Windows.h)

Voir aussi

Référence
DefWindowProc
EM_SETSEL
MSG
WM_CHAR
Conceptuel
Boîtes de dialogue