Freigeben über

PSN_QUERYINITIALFOCUS Benachrichtigungscode

  • Artikel

Wird von einem Eigenschaftenblatt gesendet, um eine Eigenschaftenblattseite bereitzustellen, um 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 . Wandeln Sie das lParam-Element dieser Struktur in einen HWND-Typ um, um das Handle des Steuerelements abzurufen, dem standardmäßig der Fokus zugewiesen wird. Die Struktur enthält eine NMHDR-Struktur als erstes Element, hdr. Das hwndFrom-Element dieser NMHDR-Struktur enthält das Handle zum Eigenschaftenblatt.

Rückgabewert

Um anzugeben, welches Steuerelement den Fokus erhalten soll, geben Sie das Handle des Steuerelements zurück. Andernfalls wird null zurückgegeben, und der Fokus wird auf das Standardsteuerelement gesetzt. 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 nicht aufrufen, während sie diesen Benachrichtigungscode verarbeitet. Gibt das Handle des Steuerelements zurück, das den Fokus erhalten soll, und der Eigenschaftenblatt-Manager übernimmt 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. Sie fordert den anfänglichen Fokus auf das Ortssteuerelement (IDC_LOCATION) an.

case PSN_QUERYINITIALFOCUS :
    SetWindowLong(hDlg,DWL_MSGRESULT, (LPARAM)GetDlgItem(hDlg, IDC_LOCATION));
    return TRUE;
...

Hinweis

Dieser Benachrichtigungscode wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Prsht.h