WM_INITDIALOG message
Envoyé à la procédure de boîte de dialogue immédiatement avant l’affichage d’une boîte de dialogue. Les procédures de boîte de dialogue utilisent généralement ce message pour initialiser des contrôles et effectuer d’autres tâches d’initialisation qui affectent l’apparence de la boîte de dialogue.
#define WM_INITDIALOG 0x0110
Paramètres
-
wParam
-
Handle du contrôle pour recevoir le focus du clavier par défaut. Le système affecte le focus clavier par défaut uniquement si la procédure de boîte de dialogue retourne TRUE.
-
lParam
-
Données d’initialisation supplémentaires. Ces données sont transmises au système en tant que paramètre lParam dans un appel à la fonction CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam ou DialogBoxParam utilisée pour créer la boîte de dialogue. Pour les feuilles de propriétés, ce paramètre est un pointeur vers la structure PROPSHEETPAGE utilisée pour créer la page. Ce paramètre est égal à zéro si une autre fonction de création de boîte de dialogue est utilisée.
Valeur retournée
La procédure de boîte de dialogue doit retourner TRUE pour que le système définisse le focus du clavier sur le contrôle spécifié par wParam. Sinon, il doit retourner FALSE pour empêcher le système de définir le focus du clavier par défaut.
La procédure de boîte de dialogue doit retourner la valeur directement. La valeur DWL_MSGRESULT définie par la fonction SetWindowLong est ignorée.
Notes
Le contrôle pour recevoir le focus clavier par défaut est toujours le premier contrôle de la boîte de dialogue qui est visible, non désactivé, et qui a le style WS_TABSTOP . Lorsque la procédure de boîte de dialogue retourne TRUE, le système vérifie le contrôle pour s’assurer que la procédure ne l’a pas désactivé. S’il a été désactivé, le système définit le focus du clavier sur le contrôle suivant qui est visible, non désactivé, et qui a le WS_TABSTOP.
Une application ne peut retourner FALSE que si elle a défini le focus du clavier sur l’un des contrôles de la boîte de dialogue.
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 |
|
Voir aussi
-
Référence
-
Conceptuel
-
Autres ressources