_Message WM INITDIALOG

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 qui doit recevoir le focus 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 la valeur true.

lParam

Données d’initialisation supplémentaires. Ces données sont passées au système en tant que paramètre lParam dans un appel à la fonction CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParamou 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 la boîte de dialogue doit retourner true pour indiquer au système de définir le focus clavier sur le contrôle spécifié par wParam. Dans le cas contraire, elle doit retourner la valeur false pour empêcher le système de définir le focus 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.

Remarques

Le contrôle qui doit recevoir le focus clavier par défaut est toujours le premier contrôle dans la boîte de dialogue qui est visible, et non désactivé, et qui a le style WS _ TABSTOP . Lorsque la procédure de la boîte de dialogue retourne la valeur true, le système vérifie le contrôle pour s’assurer que la procédure ne l’a pas désactivée. Si elle a été désactivée, le système définit le focus clavier sur le contrôle suivant qui est visible, non désactivé, et possède le paramètre WS _ TABSTOP.

Une application ne peut retourner la valeur false que si elle a défini le focus clavier sur l’un des contrôles de la boîte de dialogue.

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

Voir aussi

Référence

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Méthodologique

Boîtes de dialogue

Autres ressources

PROPSHEETPAGE