Función CuadroEntr

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

Sintaxis

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

La sintaxis de la función Cuadro de entrada tiene estos argumentos:

argumento

Descripción

mensaje

Obligatorio. Expresión de cadena que se muestra como mensaje en el cuadro de diálogo. La longitud máxima del mensaje es de aproximadamente 1024 caracteres, dependiendo del ancho de los caracteres usados. Si el mensaje consta de más de una línea, puede separar las líneas con un carácter de retorno de carro (Chr(13)), un carácter de línea (Chr(10 )) ouna combinación de caracteres de retorno de línea de carro (Chr(13) & Chr(10)) entre cada línea.

título

Opcional. Expresión de cadena que se muestra en la barra de título del cuadro de diálogo. Si omite el título,el nombre de la aplicación se coloca en la barra de título.

predeterminado

Opcional. Expresión de cadena que se muestra en el cuadro de texto como respuesta predeterminada si no se proporciona ninguna otra entrada. Si omite el valor predeterminado,el cuadro de texto se mostrará vacío.

xpos

Opcional. Expresión numérica que especifica, en twips, la distancia horizontal del borde izquierdo del cuadro de diálogo desde el borde izquierdo de la pantalla. Si se omite xpos, el cuadro de diálogo está centrado horizontalmente.

ypos

Opcional. Expresión numérica que especifica, en twips, la distancia vertical del borde superior del cuadro de diálogo desde la parte superior de la pantalla. Si omite ypos, el cuadro de diálogo se coloca verticalmente aproximadamente un tercio del camino hacia abajo en la pantalla.

archivo de ayuda

Opcional. Expresión de cadena que identifica el archivo de ayuda que se usará para proporcionar ayuda contextual para el cuadro de diálogo. Si se proporciona el archivo de ayuda, también se debe proporcionar contexto.

contexto

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


Observaciones

Cuando se proporciona el archivo de ayuda y el contexto, el usuario puede presionar F1 (Windows) o AYUDA (Macintosh) para ver el tema de ayuda correspondiente al contexto. Algunos aplicación de host, por ejemplo, Microsoft Office Excel 2007, también agregan automáticamente un botón Ayuda al cuadro de diálogo. Si el usuario hace clic en Aceptar o presiona ENTRAR, la función Cuadro de entrada devuelve lo que esté en el cuadro de texto. Si el usuario hace clic en Cancelar,la función devuelve una cadena de longitud cero ("").

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

Ejemplo

Nota: Los ejemplos siguientes muestran el uso de esta función en un módulo Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione Referencia para desarrolladores en la lista desplegable junto a Buscar y escriba uno o más términos en el cuadro de búsqueda.

En este ejemplo se muestran varias formas de usar la función Cuadro de entrada para solicitar al usuario que escriba un valor. Si se omiten las posiciones x e y, el cuadro de diálogo se centra automáticamente en los ejes respectivos. La variable MyValue contiene el valor especificado por el usuario si el usuario hace clic en Aceptar o presiona la tecla ENTRAR. Si el usuario hace clic en Cancelar,se 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)

¿Necesita más ayuda?

Ampliar sus conocimientos de Office
Explorar los cursos
Obtener nuevas características primero
Únase a los participantes de Office Insider