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
Prsht.h