Fonction ScreenSaverConfigureDialog (scrnsave.h)
Reçoit les messages envoyés à la boîte de dialogue de configuration d’un économiseur d’écran. Un économiseur d’écran qui autorise la configuration utilisateur doit définir cette fonction.
Syntaxe
BOOL ScreenSaverConfigureDialog(
HWND hDlg,
UINT message,
WPARAM wParam,
LPARAM lParam
);
Paramètres
hDlg
Type : HWND
Identificateur de la boîte de dialogue de configuration.
message
Type : UINT
Message envoyé à la boîte de dialogue de configuration de l’économiseur d’écran.
wParam
Type : WPARAM
Informations supplémentaires spécifiques au message.
lParam
Type : LPARAM
Informations supplémentaires spécifiques au message.
Valeur retournée
Type : BOOL
Si la fonction traite correctement le message, elle doit retourner TRUE. Si ce n’est pas le cas, il doit retourner FALSE, sauf en réponse à un message WM_INITDIALOG . En réponse à un message WM_INITDIALOG , ScreenSaverConfigureDialog doit retourner FALSE s’il appelle la fonction SetFocus pour définir le focus clavier sur l’un des contrôles de la boîte de dialogue. Dans le cas contraire, la fonction doit retourner TRUE, auquel cas le système définit le focus clavier sur le premier contrôle de la boîte de dialogue qui peut recevoir le focus.
Remarques
Le modèle de boîte de dialogue de la boîte de dialogue de configuration doit avoir l’identificateur DLG_SCRNSAVECONFIGURE .
La procédure de boîte de dialogue est utilisée uniquement si l’application spécifie la classe de fenêtre par défaut (WC_DIALOG) pour la boîte de dialogue. L’application utilise la classe par défaut si aucune classe explicite n’est donné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 boîte de dialogue par défaut.
La fonction ScreenSaverConfigureDialog doit être exportée en l’incluant dans l’instruction EXPORTS du fichier de définition de module (.def) de l’application.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | scrnsave.h |
| Bibliothèque | Scrnsave.lib |
| DLL | None |