4D Doc Center : Request

4D v14.3

Request


Request ( mensagem {; respostaPadrao {; okBotaoTitulo {; cancelarBotaoTitulo}}} ) -> Resultado

Parâmetro	Tipo	Descrição
mensagem	cadeia	Mensagem a exibir na caixa de diálogo de alerta
respostaPadrao	cadeia	Dados automáticos para a área de entrada de texto
okBotaoTitulo	cadeia	Título do botão OK
cancelarBotaoTitulo	cadeia	Título do botão Cancelar
Resultado	cadeia	Valor introduzido pelo usuário

Descrição

O comando Request mostra uma caixa de diálogo composta de uma mensagem, uma área de entrada de texto, um botão OK e um botão Cancelar.

A mensagem a mostrar é passada no parâmetro mensagem. Esta mensagem pode ser de até 255 caracteres. Se a mensagem não se ajusta à á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.

O usuário pode introduzir texto na área de entrada de texto. Para especificar um valor automático, passe o texto no parâmetro respostaPadrao. Se o usuário clicar no botão OK, Requestdevolve o texto. Se o usuário clique em Cancel, Request devolve uma cadeia vazia (""). Se a resposta deve ser um valor numérico ou uma data, converta a cadeia devolvida por Request ao tipo desejado com a ajuda das funções Num ou Date.

Nota: não chame o comando Request 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.

Dica: se necessita obter várias peças de informação do usuário, crie um formulário e apresente-o com DIALOG, ao invés de apresentar uma sucessão de caixas de diálogo de tipo Request.

Exemplo 1

A linha:

$vsPrompt:=Request("Por favor introduza seu nome:")

Mostrará a seguinte caixa de diálogo (em Windows):

Exemplo 2

A linha:

 vsPrompt:=Request("Nome do empregado:";"";"Criar Registro";"Cancelar")

 If(OK=1)

    ADD RECORD([Empregados])

  ` Nota: vsPrompt depois é copiado no campo[Empregados]Sobrenome

  ` durante o evento On Load no método de formulário

 End if

Mostrará a seguinte caixa de diálogo (em Windows):

Exemplo 3

A linha:

$vdPrompt:=Date(Request("Introduzir a nova data:";String(Current date)))

Mostrará a seguinte caixa de diálogo (em Windows):