Caixas de diálogo (Windows Installer)

  • Artigo

As caixas de diálogo são especificadas na coluna Dialog da tabela Dialog. Para obter mais informações sobre como adicionar uma caixa de diálogo ou um cartaz a uma interface do usuário, confira Como usar a interface do usuário.

Nomes de caixas de diálogo reservados

Os nomes das caixas de diálogo a seguir são reservados pelo Windows Installer e não devem ser usados para caixas de diálogo personalizadas criadas pelo usuário. O instalador exige que essas caixas de diálogo sejam listadas na tabela Dialog com os nomes reservados a seguir. Cada caixa de diálogo e nome só podem ser listados uma vez. Os desenvolvedores precisam criar essas caixas de diálogo na interface do usuário. Para obter informações sobre como visualizar caixas de diálogo, confira Como importar a interface do usuário.

Nome da caixa de diálogo Breve descrição da caixa de diálogo
Caixa de diálogo FilesInUse Alerta o usuário para processos de substituição ou exclusão de arquivos.
Caixa de diálogo FirstRun Coleta o nome de usuário, o nome da empresa e a ID do produto (product ID).
Caixa de diálogo MsiRMFilesInUse Alerta o usuário para processos de substituição ou exclusão de arquivos e dá a ele a opção de usar o Gerenciador de Reinicialização para fechar e reiniciar aplicativos.

 

Caixas de diálogo obrigatórias

Durante a instalação, alguns eventos fazem com que o Windows Installer verifique as tabelas de sequência de interface do usuário no pacote e exiba a caixa de diálogo especificada. Por exemplo, no caso de um erro fatal, o Windows Installer exibe a caixa de diálogo listada com um número de sequência igual a -3 na tabela de sequência da interface do usuário, independentemente do nome dessa caixa de diálogo na tabela Dialog. A seguinte tabela lista os eventos específicos e o número de sequência correspondente na tabela de sequência da interface do usuário:

Tipo de evento Número da sequência de sequência da interface do usuário Descrição da caixa de diálogo
Erro fatal -3 A instalação foi encerrada por um erro fatal.
Saída do usuário -2 A instalação foi encerrada a pedido do usuário.
Sair -1 A instalação foi concluída com sucesso.

 

Além disso, o autor do pacote precisa criar uma caixa de diálogo genérica para exibir mensagens de erro do Windows Installer. Essa caixa de diálogo pode ter qualquer nome, mas esse nome precisa ser especificado na propriedade ErrorDialog.

Caixas de diálogo típicas

As caixas de diálogo a seguir são opcionais e normalmente são incluídas na interface do usuário criada de um pacote de instalação. Essas caixas de diálogo são típicas da maioria dos assistentes de interface do usuário para instalação de arquivos. Elas podem ter qualquer nome na tabela Dialog. Os nomes mostrados são recomendados apenas para maior clareza e podem ser modificados conforme necessário. Por exemplo, duas caixas de diálogo LicenseAgreement personalizadas diferentes podem ser usadas no pacote e diferenciadas na tabela Dialog pelos nomes ProfessionalLicenseAgreement e LimitedLicenseAgreement.

Tipo de caixa de diálogo Breve descrição da caixa de diálogo
Caixa de diálogo DiskCost Indica espaço em disco insuficiente para a instalação.
Caixa de diálogo Browse Permite que o usuário selecione um diretório.
Caixa de diálogo Cancel Confirma uma solicitação para encerrar a instalação.
Caixa de diálogo do Contrato de Licença A caixa modal que exibe o contrato de licença.
Caixa de diálogo Selection Caixa modal que permite que o usuário selecione itens.