4D Doc Center : CONFIRM

4D v14.3

CONFIRM


CONFIRM ( mensagem {; okBotaoTitulo {; cancelarBotaoTitulo}} )

Parâmetro	Tipo	Descrição
mensagem	cadeia	Mensagem a exibir na caixa de diálogo de confirmação
okBotaoTitulo	cadeia	Título do botão OK
cancelarBotaoTitulo	cadeia	Título do botão Cancelar

Descrição

O comando CONFIRM mostra uma caixa de diálogo de confirmação composta de um ícone, uma mensagem, um botão OK, e um botão Cancelar.

A mensagem a mostrar é passada no parâmetro mensagem. Esta mensagem pode ter até 255 caracteres. Se a mensagem não é ajustada à área de mensagem, pode aparecer truncado, dependendo de sua longitude e da largura dos caracteres.

Automaticamente, o título do botão OK é “Aceitar” e o do botão Cancelar é “Cancelar.” Para modificar os títulos destes botões, passe os novos títulos nos parâmetros opcionais okBotaoTitulo e cancelarBotaoTitulo. Se for necessário, a largura dos botões é redimensionada até a esquerda, de acordo com a largura dos títulos personalizados que você passar.

O botão OK é o botão automático. Se o usuário clicar no botão OK ou pressiona Enter para aceitar a caixa de diálogo, a variável sistema OK toma o valor 1. Se o usuário clicar no botão Cancelar para cancelar a caixa de diálogo, a variável sistema OK toma o valor 0.

Dica: não chame ao comando CONFIRM desde um método de formulário ou de objeto que maneje os eventos de formulário On Activate ou On Deactivate; isto provocará um loop infinito.

Exemplo 1

A linha:

 CONFIRM("ADVERTÊNCIA: Essa operação não pode ser desfeita.")

 If(OK=1)

    ALL RECORDS([Coisas Antigas])

    DELETE SELECTION([Coisas Antigas])

 Else

    ALERT("Operação cancelada.")

 End if

Mostrará a caixa de diálogo de confirmação a seguir (em Windows):

Exemplo 2

A linha:

CONFIRM("Tem certeza que deseja fechar esta conta?";"Sim";"Não")

Mostrará a seguinte caixa de diálogo de confirmação (em Windows):

Exemplo 3

Imagine que você esteja desenvolvendo uma aplicação 4D para o mercado internacional e escreveu um método de projeto que retorna o texto traduzido da versão em inglês. Igualmente chega um array chamado <>asLocalizedUIMessages, onde armazena as palavras mais comuns. Ao fazer isso, a linha:

 CONFIRM(INTL Text("Quer adicionar um novo Memo?");<>asLocalizedUIMessages{kLoc_YES};

 <>asLocalizedUIMessages{kLoc_NO})

Mostrará a seguinte caixa de diálogo de confirmação:

Exemplo 4

A linha:

 CONFIRM("ADVERTÊNCIA: Se realiza esta operação, alguns registros serão "+"afetados irremediavelmente."+Char(13)+"Que quer fazer?";"NAO continuar";"Continuar")

Mostrará a seguinte caixa de diálogo de confirmação (em Macintosh):