PropSheet_SetWizButtons macro (prsht.h)

Artigo
10/24/2024

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(
   HWND  hDlg,
   DWORD 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.

Valor de retorno

Tipo: void

Nenhum valor retornado.

Observações

Essa macro usa PostMessage para enviar a mensagem de 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á 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 será capaz de definir corretamente o foco para os botões.

Os assistentes exibem três ou quatro botões abaixo de cada página. Esta 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, a configuração 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 dwFlags membro da estrutura PROPSHEETHEADER do assistente ao criar o assistente. Cada página exibirá todos os quatro botões.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	prsht.h

Compartilhar via