PSM_SETWIZBUTTONS mensagem

Habilita ou desabilita os botões Voltar, Avançar e Concluir em um assistente. Você também pode usar a macro PropSheet_SetWizButtons para postar a mensagem.

Parâmetros

wParam

Defina esse parâmetro como PSWIZBF_ELEVATIONREQUIRED para exibir o ícone elevado nos botões especificados em lParam. O ícone com privilégios elevados (ou ícone de escudo UAC) indica que o prompt de elevação será usado para solicitar aprovação ou credenciais ao usuário. Para obter mais informações, consulte Criando aplicativos UAC para Windows Vista.

Observação

A exibição do ícone de escudo UAC só tem suporte em AeroWizards (PSH_AEROWIZARD).

lParam

Valor que especifica quais botões de folha de propriedades estão habilitados. Você pode combinar um ou mais dos sinalizadores a seguir.

Valor	Significado
PSWIZB_BACK	Habilita o botão Voltar . Se esse sinalizador não estiver definido, o botão Voltar será exibido como desabilitado.
PSWIZB_DISABLEDFINISH	Exibe um botão Concluir desabilitado.
PSWIZB_FINISH	Exibe um botão Concluir habilitado.
PSWIZB_NEXT	Habilita botão Avançar. Se esse sinalizador não estiver definido, o botão Avançar será exibido como desabilitado.

Valor retornado

Sem valor de retorno.

Comentários

Se o manipulador de notificação usar PostMessage para enviar uma mensagem PSM_SETWIZBUTTONS , não faça nada que afete o foco da janela até que o manipulador retorne. Por exemplo, se você chamar MessageBox imediatamente após usar PostMessage para enviar PSM_SETWIZBUTTONS, a caixa de mensagem receberá o foco. Como as mensagens postadas não são entregues até chegarem ao cabeçalho da fila de mensagens, a mensagem PSM_SETWIZBUTTONS não será entregue até que o assistente tenha perdido o foco na caixa de mensagem. Como resultado, a folha de propriedades não poderá definir corretamente o foco para os botões.

Se você enviar a mensagem PSM_SETWIZBUTTONS durante a manipulação da notificação de PSN_SETACTIVE , use a função PostMessage em vez da função SendMessage . Caso contrário, o sistema não atualizará os botões corretamente. Se você usar a macro PropSheet_SetWizButtons para enviar essa mensagem, ela será postada. Em qualquer outro momento, você pode usar SendMessage para enviar PSM_SETWIZBUTTONS.

Os assistentes exibem três ou quatro botões abaixo de cada página. Essa mensagem é usada para especificar quais botões estão habilitados. Os assistentes normalmente exibem o botão Voltar, Cancelar e Avançar ou Concluir . Normalmente, você habilita apenas o botão Avançar para a página de boas-vindas, Avançar e Voltar para páginas interiores e Voltar e Concluir para a página de conclusão. O botão Cancelar está sempre habilitado. Normalmente, definir PSWIZB_FINISH ou PSWIZB_DISABLEDFINISH substitui o botão Avançar por um botão Concluir . Para exibir os botões Avançar e Concluir simultaneamente, defina o sinalizador PSH_WIZARDHASFINISH no membro dwFlags da estrutura PROPSHEETHEADER do assistente ao criar o assistente. Cada página exibirá todos os quatro botões.

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