IndyMsgBox

Estrutura

IndyMsgBox(sText Text; bYesNo, bAllowHiding: Boolean)

Tipo

Função

Descrição

Esta função exibe o texto sText numa pequena caixa de diálogo. Se o parâmetro bYesNo for True, a caixa de diálogo apresenta os botões «Sim» e «Não»; caso contrário, é apresentado um botão «OK». Se o parâmetro bYesNo for True, o resultado da função será 1 ou 0 (números inteiros), consoante a resposta «Sim» ou «Não»; caso contrário, o resultado será sempre True. Se o parâmetro bAllowHiding for True, é apresentada uma pequena caixa de seleção no canto inferior esquerdo da caixa de diálogo com a opção «Não voltar a apresentar esta mensagem». Se esta opção for marcada pelo utilizador, a caixa de diálogo não voltará a ser apresentada nessa estação de trabalho. (A seleção da caixa de seleção é guardada localmente no registo). Se a caixa de diálogo estiver oculta, a função passará sempre a devolver True no futuro (se bYesNo for verdadeiro).

Parâmetros: 3

; sText = o texto exibido na caixa de diálogo;

; bYesNo = se são apresentados os botões «Sim» e «Não» ou apenas um botão «OK». Ver nota acima.

bAllowHiding= opção para ocultar a caixa de diálogo no futuro. Ver nota acima.

Valor de retorno

Texto, '1' ou '0'. Nota: este «1» ou «0» é automaticamente interpretado como um valor booleano quando utilizado numa instrução «if», «if not», etc. Veja os exemplos abaixo. Ver nota acima.

Exemplos

' Pergunta de sim/não, sem opção de ocultar

if not IndyMsgBox('Deseja continuar?', True, False) then

AbortAction('Respondeu não - por isso, vamos parar')

Else

ShowMessage('A continuar com o script')

End If

' Apenas texto, com a opção de ocultar

IndyMsgBox('Esta é uma nova funcionalidade, estou apenas a explicá-la aqui.', False, True) |