PSN _ QUERYINITIALFOCUS-Benachrichtigungscode
Wird von einem Eigenschaftenblatt gesendet, um einer Eigenschaftenblattseite die Möglichkeit bereitzustellen, anzugeben, welches Dialogfeldsteuerelement den anfänglichen Fokus erhalten soll. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.
PSN_QUERYINITIALFOCUS
lppsn = (LPPSHNOTIFY) lParam;
Parameter
-
lParam
-
Zeiger auf eine PSHNOTIFY-Struktur. Umwandlung des lParam-Members dieser Struktur in einen HWND-Typ, um das Handle des Steuerelements abzurufen, das standardmäßig den Fokus erhält. Die -Struktur enthält eine NMHDR-Struktur als erstes Element, hdr. Das hwndFrom-Element dieser NMHDR-Struktur enthält das Handle für das Eigenschaftenblatt.
Rückgabewert
Um anzugeben, welches Steuerelement den Fokus erhalten soll, geben Sie das Handle des Steuerelements zurück. Andernfalls geben Sie 0 (null) zurück, und der Fokus wird an das Standardsteuerelement gerichtet. Um den Rückgabewert festzulegen, muss die Dialogfeldprozedur die SetWindowLong-Funktion mit einem _ DWL-MSGRESULT-Wert aufrufen und TRUE zurückgeben.
Bemerkungen
Eine Anwendung darf die SetFocus-Funktion bei der Verarbeitung dieses Benachrichtigungscodes nicht aufrufen. Gibt das Handle des Steuerelements zurück, das den Fokus erhalten soll, und der Eigenschaftenblatt-Manager verarbeitet die Fokusänderung.
Der PSN _ QUERYINITIALFOCUS-Benachrichtigungscode wird nicht gesendet, wenn der Eigenschaftenblatt-Manager feststellt, dass kein Steuerelement auf der Seite den Fokus erhalten soll.
Dieses Codefragment implementiert einen einfachen Handler für PSN _ QUERYINITIALFOCUS. Er fordert an, dass der anfängliche Fokus dem Standortsteuerelement (IDC _ LOCATION) gegeben wird.
case PSN_QUERYINITIALFOCUS :
SetWindowLong(hDlg,DWL_MSGRESULT, (LPARAM)GetDlgItem(hDlg, IDC_LOCATION));
return TRUE;
...
Hinweis
Dieser Benachrichtigungscode wird nicht unterstützt, wenn sie den Stil des Assistenten Für Dies verwendet wird (_ PSHWIEWIESWIZARD).
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|