Fonction de rappel DLGPROC (winuser.h)

Article
03/04/2024

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.

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)