Caixa de diálogo Erro

Uma caixa de diálogo Erro é uma caixa de diálogo modal que exibe uma mensagem de erro. Mais de uma caixa de diálogo Erro pode existir em cada instalação.

É necessário definir uma propriedade ErrorDialog que especifique 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 de caixa de diálogo Erro definido. A caixa de diálogo deve ter um Controle de texto chamado ErrorText. O registro da caixa de diálogo Erro na tabela Diálogo 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 ControlEvent EndDialog 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 por meio 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 ele é criado, 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 Y, a altura e a largura dos botões não são alteradas. 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 Diálogo são ignorados. O campo Control_First de 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.