ScreenSaverConfigureDialog-Funktion (scrnsave.h)

  • Artikel

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

Siehe auch

RegisterDialogClasses