ScreenSaverConfigureDialog-Funktion (scrnsave.h)
Empfängt Nachrichten, die an das Konfigurationsdialogfeld eines Bildschirmschoners gesendet werden. Ein Bildschirmschoner, der die Benutzerkonfiguration zulässt, muss diese Funktion definieren.
Syntax
BOOL ScreenSaverConfigureDialog(
HWND hDlg,
UINT message,
WPARAM wParam,
LPARAM lParam
);
Parameter
hDlg
Typ: HWND
Der Bezeichner des Konfigurationsdialogfelds.
message
Typ: UINT
Eine Nachricht, die an das Konfigurationsdialogfeld des Bildschirmschoners gesendet wurde.
wParam
Typ: WPARAM
Zusätzliche meldungsspezifische Informationen.
lParam
Typ: LPARAM
Zusätzliche meldungsspezifische Informationen.
Rückgabewert
Typ: BOOL
Wenn die Funktion die Nachricht erfolgreich verarbeitet, sollte sie TRUE zurückgeben. Andernfalls sollte false zurückgegeben werden, außer als Reaktion auf eine WM_INITDIALOG Nachricht. Als Reaktion auf eine WM_INITDIALOG Meldung sollte ScreenSaverConfigureDialogFALSE zurückgeben, wenn die SetFocus-Funktion aufgerufen wird, um den Tastaturfokus auf eines der Steuerelemente im Dialogfeld festzulegen. Andernfalls sollte die Funktion TRUE zurückgeben. In diesem Fall legt das System den Tastaturfokus auf das erste Steuerelement im Dialogfeld fest, dem der Fokus zugewiesen werden kann.
Hinweise
Die Dialogfeldvorlage für das Konfigurationsdialogfeld muss über den DLG_SCRNSAVECONFIGURE-Bezeichner verfügen.
Die Dialogfeldprozedur wird nur verwendet, wenn die Anwendung die Standardfensterklasse (WC_DIALOG) für das Dialogfeld angibt. Die Anwendung verwendet die Standardklasse, wenn in der Dialogfeldvorlage keine explizite Klasse angegeben ist. Obwohl die Dialogfeldprozedur einer Fensterprozedur ähnelt, darf sie die Funktion DefWindowProc nicht aufrufen, um unerwünschte Nachrichten zu verarbeiten. Unerwünschte Nachrichten werden intern durch die Standarddialogfeldprozedur verarbeitet.
Die ScreenSaverConfigureDialog-Funktion muss exportiert werden, indem Sie sie in die EXPORT-Anweisung in die Moduldefinitionsdatei (DEF) der Anwendung aufnehmen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | scrnsave.h |
| Bibliothek | Scrnsave.lib |
| DLL | Keine |