Función InputBox

Artículo
04/07/2023

Muestra una pregunta en un cuadro de diálogo, espera a que el usuario escriba el texto o haga clic en un botón y devuelve una String que contiene el contenido del cuadro de texto.

Sintaxis

InputBox(prompt, [ title ], [ default ], [ xpos ], [ ypos ], [ helpfile, context ])

La sintaxis de la función InputBox consta de los argumentos con nombre siguientes:

Parte	Descripción
prompt	Obligatorio. Expresión de cadena que aparece como mensaje en el cuadro de diálogo. La longitud máxima de prompt es de aproximadamente 1024 caracteres, según el ancho de los caracteres utilizados. Si prompt consta de más de una línea, puede separar las líneas mediante 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 ((Chr(13) & (Chr(10)) entre cada línea.
title	Opcional. Expresión de cadena que aparece como barra de titulo en el cuadro de diálogo. Si omite title, el nombre de aplicación se coloca en la barra de título.
default	Opcional. Expresión de cadena que aparece en el cuadro de texto como respuesta predeterminada si no se proporciona ninguna otra entrada. Si se omite default, el cuadro de texto aparece vacío.
xpos	Opcional. 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	Opcional. 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 hacia abajo en la pantalla.
helpfile	Opcional. Expresión de cadena que identifica el archivo de Ayuda que se usa para proporcionar ayuda contextual para el cuadro de diálogo. Si se proporciona helpfile, también se debe proporcionar context.
context	Opcional. Expresión numérica que es el número de contexto de Ayuda asignado al tema correspondiente de la Ayuda por el autor de la misma. Si se proporciona context, también se debe proporcionar helpfile.

Observaciones

Cuando se proporcionan helpfile y context, el usuario puede presionar F1 (Windows) o AYUDA (Macintosh) para ver el tema de Ayuda correspondiente a context. Algunas aplicaciones host, por ejemplo Microsoft Excel, agregan automáticamente un botón Ayuda al cuadro de diálogo. Si el usuario selecciona Aceptar o presiona ENTRAR, la función InputBox devuelve lo que está en el cuadro de texto. Si el usuario seleccionaCancelar, la función devuelve una cadena de longitud cero ("").

El cuadro de texto solo acepta 255 caracteres. La cadena de retorno se trunca en 254 caracteres.

El cuadro de texto no acepta saltos de línea, como Mayús+Entrar. Si el usuario pega texto con un salto de línea en el cuadro de texto, el texto se trunca en el salto de línea.

Nota:

Para especificar más que el primer argumento con nombre, debe usar InputBox en una expresión. Para omitir algunos argumentos posicionales, debe incluir el delimitador de coma correspondiente.

Ejemplo

En este ejemplo, se muestran varias formas de usar la función InputBox para pedir al usuario que escriba un valor. Si las posiciones de x e y posiciones se omiten, el cuadro de diálogo se centra automáticamente en los ejes correspondientes. La variable MyValue contiene el valor especificado por el usuario si el usuario selecciona Aceptar o presiona la tecla ENTRAR. Si el usuario selecciona Cancelar, la función devuelve una cadena de longitud cero.

Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3"    ' Set prompt.
Title = "InputBox Demo"    ' Set title.
Default = "1"    ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)

' Use Helpfile and context. The Help button is added automatically.
MyValue = InputBox(Message, Title, , , , "DEMO.HLP", 10)

' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)

Consulte también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.