InputBox (método)
Importante
Este artículo se ha traducido con traducción automática; vea la declinación de responsabilidades. Para su referencia, puede encontrar la versión en inglés de este artículo aquí.
Muestra un cuadro de diálogo para que el usuario escriba información. Devuelve la información escrita en el cuadro de diálogo.
Sintaxis
expresión .InputBox(Prompt, Title, Default, Left, Top, HelpFile, HelpContextID, Type)
expresión Variable que representa un objetoApplication object.
Parámetros
Name |
Necesario/Opcional |
Tipo de datos |
description |
---|---|---|---|
Prompt |
Obligatorio |
String |
Mensaje que se mostrará en el cuadro de diálogo. Puede ser una cadena, un número, una fecha o un valor Boolean (Microsoft Excel automáticamente convierte el valor en una cadena String antes de mostrarla). |
Title |
Opcional |
Variante |
El título del cuadro de entrada. Si este argumento se omite, el título predeterminado será "Entrada". |
Default |
Opcional |
Variante |
Especifica un valor que aparecerá en el cuadro de texto cuando se muestre inicialmente el cuadro de diálogo. Si este argumento se omite, el cuadro de texto permanecerá vacío. Este valor puede ser un objeto Range. |
LEFT |
Opcional |
Variante |
Especifica la posición X del cuadro de diálogo con respecto a la esquina superior izquierda de la pantalla, en puntos. |
Top |
Opcional |
Variante |
Especifica la posición Y del cuadro de diálogo con respecto a la esquina superior izquierda de la pantalla, en puntos. |
HelpFile |
Opcional |
Variante |
Nombre del archivo de Ayuda para este cuadro de entrada. Si los argumentos HelpFile y HelpContextID están presentes, aparecerá un botón Ayuda en el cuadro de diálogo. |
HelpContextID |
Opcional |
Variante |
La identificación de contexto del tema de Ayuda en HelpFile. |
Type |
Opcional |
Variante |
Especifica el tipo de datos que se devuelve. Si este argumento se omite, el cuadro de diálogo devolverá texto. |
Valor devuelto
Variante
Notas
En la tabla siguiente se enumeran los valores que se pueden pasar en el argumento Type. Puede ser uno de los valores siguientes o bien una suma de ellos. Por ejemplo, para que un cuadro de entrada acepte texto o números, establezca Type como 1 + 2.
Valor (Value) |
Significado |
---|---|
0 |
Una fórmula |
1 |
Un número |
2 |
Texto (una cadena) |
4 |
Un valor lógico (True o False) |
8 |
Una referencia a una celda, como un objeto Range. |
16 |
Un valor de error, como por ejemplo #N/A |
64 |
Una matriz de valores |
Use InputBox para mostrar un cuadro de diálogo sencillo que permite escribir información para usarla en una macro. El cuadro de diálogo tiene un botón Aceptar y un botón Cancelar. Si elige el botón Aceptar, InputBox devolverá el valor escrito en el cuadro de diálogo. Si elige el botón Cancelar, InputBox devolverá False.
Si Type es 0, InputBox devuelve la fórmula en forma de texto, por ejemplo, "= 2 * PI () / 360". Si hay alguna referencia en la fórmula, se devolverán como referencias de estilo A1. (Utilice ConvertFormula para convertir entre estilos de referencia).
Si Type es 8, InputBox devolverá un objeto Range. Debe usar el enunciado SetSet para asignar el resultado a un objeto Range, como se muestra en el ejemplo siguiente:
Set myRange = Application.InputBox(prompt := "Sample", type := 8)
Si no usa la instrucción Set, se asignará a la variable el valor contenido en el rango y no el propio objeto Range.
Si utiliza el método InputBox para solicitar al usuario una fórmula, debe utilizar el FormulaLocal propiedad para asignar la fórmula a un objeto Range. La fórmula introducida estará en el idioma del usuario.
El método InputBox difiere de la función InputBox en que permite la validación selectiva de las entradas del usuario y en que puede usarse con objetos, valores de error y fórmulas de Microsoft Excel. Tenga en cuenta que Application.InputBox llama al método InputBox; InputBox, sin calificador de objeto, llama a la función InputBox function.
Ejemplo
En este ejemplo se solicita un número al usuario.
myNum = Application.InputBox("Enter a number")
Ejemplo
En este ejemplo se solicita al usuario que seleccione una celda de Sheet1. Se usa el argumento Type para asegurar que valor devuelto es una referencia de celda válida (un objeto Range).
Worksheets("Sheet1").Activate
Set myCell = Application.InputBox( _
prompt:="Select a cell", Type:=8)
Nota
Declinación de responsabilidades de traducción automática: Este artículo se ha traducido con un sistema informático sin intervención humana. Microsoft ofrece estas traducciones automáticas para que los hablantes de otros idiomas distintos del inglés puedan disfrutar del contenido sobre los productos, los servicios y las tecnologías de Microsoft. Puesto que este artículo se ha traducido con traducción automática, es posible que contenga errores de vocabulario, sintaxis o gramática.