Compartir vía

PSN_QUERYINITIALFOCUS código de notificación

  • Artículo

Enviado por una hoja de propiedades para proporcionar una página de hoja de propiedades una oportunidad para especificar qué control de cuadro de diálogo debe recibir el foco inicial. Este código de notificación se envía en forma de mensaje WM_NOTIFY .

PSN_QUERYINITIALFOCUS

    lppsn = (LPPSHNOTIFY) lParam;

Parámetros

lParam

Puntero a una estructura PSHNOTIFY . Convierta el miembro lParam de esta estructura en un tipo HWND para recuperar el identificador del control al que se le asignará el foco de forma predeterminada. La estructura contiene una estructura NMHDR como primer miembro, hdr. El miembro hwndFrom de esta estructura NMHDR contiene el identificador de la hoja de propiedades.

Valor devuelto

Para especificar qué control debe recibir el foco, devuelva el identificador del control. De lo contrario, devuelve cero y el foco irá al control predeterminado. Para establecer el valor devuelto, el procedimiento del cuadro de diálogo debe llamar a la función SetWindowLong con un valor DWL_MSGRESULT y devolver TRUE.

Observaciones

Una aplicación no debe llamar a la función SetFocus mientras controla este código de notificación. Devuelve el identificador del control que debe recibir el foco y el administrador de hojas de propiedades controlará el cambio de foco.

El PSN_QUERYINITIALFOCUS código de notificación no se envía si el administrador de hojas de propiedades determina que ningún control de la página debe recibir el foco.

Este fragmento de código implementa un controlador sencillo para PSN_QUERYINITIALFOCUS. Solicita que el foco inicial se dé al control Ubicación (IDC_LOCATION).

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

Nota

Este código de notificación no se admite al usar el estilo del asistente aero (PSH_AEROWIZARD).

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Prsht.h