Fonction de rappel DLGPROC (winuser.h)
Fonction de rappel définie par l’application utilisée avec les familles de fonctions CreateDialog et DialogBox . Il traite les messages envoyés à une boîte de dialogue modale ou sans mode. Le type DLGPROC définit un pointeur vers cette fonction de rappel. DialogProc est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
DLGPROC Dlgproc;
INT_PTR Dlgproc(
HWND unnamedParam1,
UINT unnamedParam2,
WPARAM unnamedParam3,
LPARAM unnamedParam4
)
{...}
Paramètres
unnamedParam1
Type : HWND
Handle de la boîte de dialogue.
unnamedParam2
Type : UINT
Message.
unnamedParam3
Type : WPARAM
Informations supplémentaires spécifiques au message.
unnamedParam4
Type : LPARAM
Informations supplémentaires spécifiques au message.
Type : INT_PTR
En règle générale, la procédure de boîte de dialogue doit retourner TRUE si elle a traité le message et FALSE si ce n’est pas le cas. Si la procédure de boîte de dialogue retourne FALSE, le gestionnaire de dialogue effectue l’opération de boîte de dialogue par défaut en réponse au message.
Si la procédure de boîte de dialogue traite un message qui nécessite une valeur de retour spécifique, la procédure de boîte de dialogue doit définir la valeur de retour souhaitée en appelant SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult) immédiatement avant de renvoyer TRUE. Notez que vous devez appeler SetWindowLong immédiatement avant de retourner TRUE ; Cela peut entraîner le remplacement de la valeur DWL_MSGRESULT par un message de boîte de dialogue imbriquée.
Les messages suivants sont des exceptions aux règles générales indiquées ci-dessus. Pour plus d’informations sur la sémantique de la valeur de retour, consultez la documentation relative au message spécifique.
- WM_CHARTOITEM
- WM_COMPAREITEM
- WM_CTLCOLORBTN
- WM_CTLCOLORDLG
- WM_CTLCOLOREDIT
- WM_CTLCOLORLISTBOX
- WM_CTLCOLORSCROLLBAR
- WM_CTLCOLORSTATIC
- WM_INITDIALOG
- WM_QUERYDRAGICON
- WM_VKEYTOITEM
Valeur de retour
None
Remarques
Vous devez utiliser la procédure de boîte de dialogue uniquement si vous utilisez la classe de boîte de dialogue pour la boîte de dialogue. Il s’agit de la classe par défaut et est utilisée lorsqu’aucune classe explicite n’est spécifiée dans le modèle de boîte de dialogue. Bien que la procédure de boîte de dialogue soit similaire à une procédure de fenêtre, elle ne doit pas appeler la fonction DefWindowProc pour traiter les messages indésirables. Les messages indésirables sont traités en interne par la procédure de fenêtre de 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] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
Voir aussi
Conceptuel
Référence