Request

4D v16.3

Request


Request ( mensaje {; respuestaDefecto {; titulobotonOK {; titulobotoncancel}}} ) -> Resultado

Parámetro	Tipo	Descripción
mensaje	Cadena	Mensaje a mostrar en la caja de diálogo
respuestaDefecto	Cadena	Valor por defecto en el área de entrada de texto
titulobotonOK	Cadena	Título del botón Aceptar
titulobotoncancel	Cadena	Título del botón Cancelar
Resultado	Cadena	Valor introducido por el usuario

Descripción

El comando Request muestra una caja de diálogo compuesta de un mensaje, un área de entrada de texto, un botón OK y un botón Cancelar.

El mensaje a mostrar se pasa en el parámetro mensaje. Si el mensaje no se ajusta al área de mensaje (por lo general alrededor de 50 caracteres, varía dependiendo del sistema y de la fuente utilizada), puede aparecer truncado.

Por defecto, título del botón OK es “Aceptar” y el del botón Cancelar es “Cancelar.” Para cambiar los títulos de estos botones, pase los nuevos títulos en los parámetros opcionales titulobotonOK y titulobotoncancel. Si es necesario, el ancho de los botones se redimensiona hacia la izquierda, de acuerdo al ancho de los títulos personalizados que usted pase.

El botón OK es el botón por defecto. Si el usuario hace clic en el botón OK o presiona Intro para aceptar la caja de diálogo, la variable sistema OK toma el valor 1. Si el usuario hace clic en el botón Cancelar para cancelar la caja de diálogo, la variable sistema OK toma el valor 0.

El usuario puede introducir texto en el área de entrada de texto. Para especificar un valor por defecto, pase el texto por defecto en el parámetro respuestaDefecto. Si el usuario hace clic en el botón OK, Request devuelve el texto. Si el usuario hace clic en Cancelar, Request devuelve una cadena vacía (""). Si la respuesta debe ser un valor numérico o una fecha, convierta la cadena devuelta por Request al tipo deseado con la ayuda de las funciones Num or Date.

Nota: no llame el comando Request desde un método de formulario o de objeto que maneje los eventos de formulario On Activate o On Deactivate; esto provocará un bucle infinito.

Consejo: si necesita obtener varias piezas de información del usuario, diseñe un formulario y preséntelo con DIALOG, en lugar de presentar una sucesión de cajas de diálogo de tipo Request.

Ejemplo 1

La línea:

$vsPrompt:=Request("Por favor introduzca su nombre:")

Mostrará la siguiente caja de diálogo (en Windows):

Ejemplo 2

La línea:

 vsPrompt:=Request("Nombre del empleado:";"";"Crear Registro";"Cancelar")

 If(OK=1)

    ADD RECORD([Empleados])

  ` Nota: vsPrompt luego se copia en el campo[Empleados]Apellido

  ` durante el evento On Load en el método de formulario

 End if

Mostrará la siguiente caja de diálogo (en Windows):

Ejemplo 3

La línea:

$vdPrompt:=Date(Request("Introduzca la nueva fecha:";String(Current date)))

Mostrará la siguiente caja de diálogo (en Windows):

Ver también

ALERT
CONFIRM