Compartilhar via

PSN_QUERYINITIALFOCUS código de notificação

  • Artigo

Enviada por uma folha de propriedades para fornecer a uma página de folha de propriedades uma oportunidade de especificar qual controle de caixa de diálogo deve receber o foco inicial. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY .

PSN_QUERYINITIALFOCUS

    lppsn = (LPPSHNOTIFY) lParam;

Parâmetros

lParam

Ponteiro para uma estrutura PSHNOTIFY . Converta o membro lParam dessa estrutura em um tipo HWND para recuperar o identificador do controle que receberá o foco por padrão. A estrutura contém uma estrutura NMHDR como seu primeiro membro, hdr. O membro hwndFrom dessa estrutura NMHDR contém o identificador para a folha de propriedades.

Valor retornado

Para especificar qual controle deve receber o foco, retorne o identificador do controle. Caso contrário, retorne zero e o foco irá para o controle padrão. Para definir o valor retornado, o procedimento da caixa de diálogo deve chamar a função SetWindowLong com um valor DWL_MSGRESULT e retornar TRUE.

Comentários

Um aplicativo não deve chamar a função SetFocus ao manipular esse código de notificação. Retorne o identificador do controle que deve receber o foco e o gerenciador de folhas de propriedades manipulará a alteração de foco.

O código de notificação PSN_QUERYINITIALFOCUS não será enviado se o gerenciador de folhas de propriedades determinar que nenhum controle na página deve receber o foco.

Esse fragmento de código implementa um manipulador simples para PSN_QUERYINITIALFOCUS. Ele solicita que o foco inicial seja dado ao controle Local (IDC_LOCATION).

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

Observação

Não há suporte para esse código de notificação ao usar o estilo do assistente aero (PSH_AEROWIZARD).

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Prsht.h