Share via

macro PropSheet_SetWizButtons (prsht.h)

  • Artigo

Habilita ou desabilita os botões Voltar, Avançar e Concluir em um assistente postando uma mensagem PSM_SETWIZBUTTONS . Você pode usar essa macro ou enviar a mensagem PSM_SETWIZBUTTONS explicitamente.

Sintaxe

void PropSheet_SetWizButtons(
   hDlg,
   dwFlags
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a folha de propriedades.

dwFlags

Tipo: DWORD

Um valor que especifica quais botões do assistente estão habilitados. Você pode combinar um ou mais dos sinalizadores a seguir.

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

Retornar valor

Nenhum

Comentários

Essa macro usa PostMessage para enviar a mensagem PSM_SETWIZBUTTONS . Se o manipulador de notificação chamar PropSheet_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 chamar PropSheet_SetWizButtons, a caixa de mensagem receberá o foco. Como as mensagens enviadas com PostMessage 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.

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 internas 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]
Plataforma de Destino Windows
Cabeçalho prsht.h