Fonction de rappel LPFRHOOKPROC (commdlg.h)
Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Rechercher ou remplacer . La procédure de crochet FRHookProc est une fonction de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec la fonction FindText ou ReplaceText .
Le type LPFRHOOKPROC définit un pointeur vers cette fonction de rappel. FRHookProc est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
LPFRHOOKPROC Lpfrhookproc;
UINT_PTR Lpfrhookproc(
HWND unnamedParam1,
UINT unnamedParam2,
WPARAM unnamedParam3,
LPARAM unnamedParam4
)
{...}
Paramètres
unnamedParam1
Handle de la boîte de dialogue Rechercher ou remplacer pour laquelle le message est destiné.
unnamedParam2
Identificateur du message reçu.
unnamedParam3
Informations supplémentaires sur le message. La signification exacte dépend de la valeur du paramètre unnamedParam2 .
unnamedParam4
Informations supplémentaires sur le message. La signification exacte dépend de la valeur du paramètre unnamedParam2 .
Si le paramètre unnamedParam2 indique le message WM_INITDIALOG , unnamedParam4 est un pointeur vers une structure FINDREPLACE contenant les valeurs spécifiées lors de la création de la boîte de dialogue.
Valeur retournée
Si la procédure de hook retourne zéro, la procédure de boîte de dialogue par défaut traite le message.
Si la procédure de hook retourne une valeur différente de zéro, la procédure de boîte de dialogue par défaut ignore le message.
Remarques
Lorsque vous utilisez les fonctions FindText ou ReplaceText pour créer une boîte de dialogue Rechercher ou Remplacer , vous pouvez fournir une procédure de crochet FRHookProc pour traiter les messages ou notifications destinés à la procédure de boîte de dialogue. Pour activer la procédure de hook, utilisez la structure FINDREPLACE que vous avez passée à la fonction de création de dialogue. Spécifiez l’adresse de la procédure de crochet dans le membre lpfnHook et spécifiez l’indicateur FR_ENABLEHOOK dans le membre Flags .
La procédure de boîte de dialogue par défaut traite le message WM_INITDIALOG avant de le passer à la procédure de hook. Pour tous les autres messages, la procédure de crochet reçoit d’abord le message. Ensuite, la valeur de retour de la procédure de hook détermine si la procédure de dialogue par défaut traite le message ou l’ignore.
Si la procédure de crochet traite le message WM_CTLCOLORDLG , elle doit retourner une poignée de pinceau valide pour peindre l’arrière-plan de la boîte de dialogue. En général, si la procédure de crochet traite un message WM_CTLCOLOR* , elle doit retourner une poignée de pinceau valide pour peindre l’arrière-plan du contrôle spécifié.
N’appelez pas la fonction EndDialog à partir de la procédure de hook. Au lieu de cela, la procédure de crochet peut appeler la fonction PostMessage pour publier un message WM_COMMAND avec la valeur IDABORT dans la procédure de boîte de dialogue. La publication d’IDABORT ferme la boîte de dialogue et entraîne le retour de la fonction de boîte de dialogue FALSE. Si vous avez besoin de savoir pourquoi la procédure de hook a fermé la boîte de dialogue, vous devez fournir votre propre mécanisme de communication entre la procédure de hook et votre application.
Vous pouvez sous-classer les contrôles standard d’une boîte de dialogue commune. Toutefois, la procédure de boîte de dialogue peut également sous-classer les contrôles. Pour cette raison, vous devez effectuer des contrôles de sous-classe lorsque votre procédure de hook traite le message WM_INITDIALOG . Cela garantit que votre procédure de sous-classe reçoit les messages spécifiques au contrôle avant la procédure de sous-classe définie par la procédure 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 | commdlg.h (inclure Windows.h) |
Voir aussi
Bibliothèque de boîtes de dialogue commune
Conceptuel
Référence