_Application.InputBox Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Excel

Ensamblado:

Microsoft.Office.Interop.Excel.dll

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 Object

Pará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

Object

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 .