Caixa de diálogo Erro
Uma caixa de diálogo Erro é uma caixa de diálogo modal que exibe uma mensagem de erro. Pode existir mais de uma caixa de diálogo Erro em cada instalação.
Uma propriedade ErrorDialog precisa ser definida que especifica qual caixa de diálogo deve ser usada. Se essa propriedade não estiver definida ou não apontar para uma caixa de diálogo Erro válida, as mensagens de erro não serão exibidas. Nesse caso, o erro só é registrado com um aviso sobre a caixa de diálogo ausente.
Uma caixa de diálogo Erro deve ter o bit de estilo Caixa de Diálogo de Erro definido. A caixa de diálogo deve ter um controle Text chamado ErrorText. O registro para a caixa de diálogo Error na tabela Dialog deve ter o controle ErrorText inserido no campo Control_First.
A caixa de diálogo deve conter sete PushButtons. Todos esses botões especificam o EndDialog ControlEvent na tabela ControlEvent. Cada botão especifica um dos seguintes atributos: ErrorAbort, ErrorCancel, ErrorIgnore, ErrorNo, ErrorOk, ErrorRetry, ErrorYes.
Observação
O foco desses controles não deve ser vinculado através do uso da coluna Control_Next na tabela Control.
Esses botões devem ser colocados aproximadamente na mesma posição na caixa de diálogo porque, quando ela é criada, apenas um subconjunto desses sete botões é criado, dependendo da mensagem. A coordenada X dos botões é modificada para que os botões exibidos sejam espaçados uniformemente. A coordenada, altura e largura Y dos botões permanecem inalteradas. Como os botões são organizados horizontalmente, nenhum outro controle pode ser colocado na mesma região horizontal da caixa de diálogo.
Para uma caixa de diálogo Erro, os campos Control_Default e Control_Cancel na tabela Caixa de Diálogo são ignorados. O campo Control_First para uma caixa de diálogo Erro deve especificar o controle ErrorText.
Se um controle Icon chamado ErrorIcon estiver incluído nessa caixa de diálogo, os seguintes ícones padrão do Windows serão exibidos:
- IDI_ERROR em resposta a mensagens imtFatalExit .
- IDI_WARNING em resposta a mensagens imtError e imtWarning.
- IDI_INFORMATION em resposta a mensagens imtOutOfDiskSpace.
O controle ErrorIcon deve ser criado com o atributo de controle FixedSize definido para evitar o dimensionamento inadequado dos ícones padrão do Windows.