_Application.InputBox Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Muestra un cuadro de diálogo para la entrada del usuario. Devuelve la información introducida en el cuadro de diálogo.
public object InputBox (string Prompt, object Title, object Default, object Left, object Top, object HelpFile, object HelpContextID, object Type);Public Function InputBox (Prompt As String, Optional Title As Object, Optional Default As Object, Optional Left As Object, Optional Top As Object, Optional HelpFile As Object, Optional HelpContextID As Object, Optional Type As Object) As ObjectParámetros
- Prompt
- String
Objeto obligatorio. Mensaje que se mostrará en el cuadro de diálogo. Puede ser una cadena, un número, una fecha o un valor booleano .
- Title
- Object
Objeto opcional. Título para el cuadro de entrada. Si este argumento se omite, el título predeterminado será "Entrada".
- Default
- Object
Objeto opcional. 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
- Object
Objeto opcional. Especifica una posición x para el cuadro de diálogo en relación con la esquina superior izquierda de la pantalla en puntos.
- Top
- Object
Objeto opcional. Especifica una posición y para el cuadro de diálogo en relación con la esquina superior izquierda de la pantalla en puntos.
- HelpFile
- Object
Objeto opcional. Nombre del archivo de Ayuda para este cuadro de entrada. Si los HelpFile argumentos y HelpContextID están presentes, aparecerá un botón Ayuda en el cuadro de diálogo.
- HelpContextID
- Object
Objeto opcional. Número de identificador de contexto del tema de Ayuda en HelpFile.
- Type
- Object
Objeto opcional. Especifica el tipo de datos que se devuelve. Si se omite este argumento, el cuadro de diálogo devolverá texto. Puede ser uno o una suma de los siguientes valores. Puede usar la suma de los valores permitidos para Type. Por ejemplo, para un cuadro de entrada que puede aceptar texto y números, establezca en Type 1 + 2.
Devoluciones
Comentarios
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 existen referencias en la fórmula, estas se devuelven como referencias de estilo A1. (Se usa ConvertFormula(Object, XlReferenceStyle, Object, Object, Object) para convertir entre estilos de referencia).
Si Type es 8, InputBox devuelve un objeto Range .
Si usa el método InputBox para pedir al usuario una fórmula, debe usar la FormulaLocal propiedad para asignar la fórmula a un objeto Range . La fórmula de entrada estará en el idioma del usuario.
El método InputBox difiere de la función InputBox en que permite la validación selectiva de la entrada del usuario y se puede usar con objetos de Microsoft Excel, valores de error y fórmulas. InputBox sin calificador de objeto llama a la función InputBox .