Compartilhar via

Caixas de diálogo (Windows Installer)

  • Artigo

As caixas de diálogo são especificadas na coluna Caixa de diálogo da tabela de diálogo . Para obter mais informações sobre como adicionar uma caixa de diálogo ou outdoor a uma interface do usuário, consulte Usando a interface do usuário.

Nomes de caixas de diálogo reservadas

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 requer que essas caixas de diálogo sejam listadas na tabela de diálogo usando os seguintes nomes reservados. Cada caixa de diálogo e o nome só podem ser listados uma vez. Os desenvolvedores devem criar essas caixas de diálogo na interface do usuário. Para obter informações sobre como visualizar caixas de diálogo, consulte Importando a interface do usuário.

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

 

Caixas de diálogo necessárias

Durante a instalação, determinados eventos fazem com que o Windows Installer marque 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 de -3 na tabela de sequência de interface do usuário, independentemente do nome da caixa de diálogo na tabela de diálogo . A tabela a seguir lista os eventos específicos e o número de sequência correspondente na tabela de sequência de interface do usuário:

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

 

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

Caixas de diálogo típicas

As caixas de diálogo a seguir são opcionais e geralmente 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 instalar arquivos. Essas caixas de diálogo podem ter qualquer nome na tabela De diálogo. 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 distinguidas na tabela de diálogo 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 Procurar Permite que o usuário selecione um diretório.
caixa de diálogo Cancelar Confirma uma solicitação para encerrar a instalação.
caixa de diálogo Contrato de Licença Caixa modal exibindo o contrato de licença.
caixa de diálogo Seleção Caixa modal permitindo que o usuário selecione itens.