Cuadro de entrada

Muestra un mensaje en un cuadro de diálogo, espera a que el usuario introduzca texto o haga clic en un botón, y devuelve el contenido del cuadro de texto.

Estructura

InputBox(mensaje[, título][, valor predeterminado][, posición horizontal][, posición vertical][, archivo de ayuda, contexto])

Parámetros

mensaje de solicitud: cadena que se muestra como mensaje en el cuadro de diálogo. La longitud máxima de la línea de comandos es de aproximadamente 1024 caracteres, dependiendo de la anchura de los caracteres utilizados. Si la línea de comando consta de más de una línea, puedes separarlas utilizando un carácter de retorno de carro (Chr(13)), un carácter de salto de línea (Chr(10)) o una combinación de caracteres de retorno de carro y salto de línea (Chr(13) & Chr(10)) entre cada línea.

título: cadena de texto que se muestra en la barra de título del cuadro de diálogo. Si no se indica ningún título, se mostrará el nombre de la aplicación en la barra de título.

por defecto: expresión de cadena que se muestra en el cuadro de texto como respuesta predeterminada si no se introduce ningún otro dato. Si no se especifica ningún valor predeterminado, el cuadro de texto se muestra vacío.

xpos: expresión numérica que especifica, en twips, la distancia horizontal entre el borde izquierdo del cuadro de diálogo y el borde izquierdo de la pantalla. Si se omite xpos, el cuadro de diálogo se centra horizontalmente.

ypos: expresión numérica que especifica, en twips, la distancia vertical entre el borde superior del cuadro de diálogo y la parte superior de la pantalla. Si se omite ypos, el cuadro de diálogo se coloca verticalmente aproximadamente a un tercio de la altura de la pantalla.

helpfile: expresión de cadena que identifica el archivo de ayuda que se utilizará para proporcionar ayuda contextual en el cuadro de diálogo. Si se proporciona el archivo de ayuda, también debe proporcionarse el contexto.

contexto: expresión numérica que identifica el número de contexto de la Ayuda asignado por el autor de la Ayuda al tema correspondiente. Si se proporciona el contexto, también debe proporcionarse el archivo de ayuda.

Descripción

Cuando se especifican tanto el archivo de ayuda como el contexto, se añade automáticamente un botón de Ayuda al cuadro de diálogo.

Si el usuario hace clic en «Aceptar» o pulsa la tecla Intro, la función InputBox devuelve el contenido del cuadro de texto. Si el usuario hace clic en «Cancelar», la función devuelve una cadena de longitud cero ('').

Ejemplo

En el siguiente ejemplo se utiliza la función InputBox para mostrar un cuadro de diálogo de entrada y asignar la cadena a la variable Input:

Dim Input

Input = InputBox("Introduce tu nombre")

MsgBox("Has introducido: " & Input) |