Función CuadroEntr

Nota:  Nos gustaría proporcionarle el contenido de ayuda actual lo más rápido posible en su idioma. Esta página se ha traducido mediante un sistema automático y es posible que contenga imprecisiones o errores gramaticales. Nuestro objetivo es que este contenido sea útil para usted. ¿Puede informarnos sobre si la información le ha sido útil al final de la página? Aquí tiene el artículo en inglés para que pueda consultarlo fácilmente.

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

CuadroEntr ( pregunta [título ] [predeterminado ] [, xpos ] [, ypos ] [, archivo de ayuda ] [contexto ] )

La sintaxis de la función CuadroEntr tiene los siguientes argumentos:

Argumento

Descripción

símbolo del sistema

Obligatorio. Expresión que se muestra como mensaje en el cuadro de diálogo de cadena. La longitud máxima del símbolo del sistema es de aproximadamente 1024 caracteres, según el ancho de los caracteres utilizados. Si se pregunta consta de más de una línea, puede separar las líneas mediante un carácter de retorno de carro (Chr13)(), un carácter de salto de línea (Chr10)() o el carácter y avance de línea de retorno de carro combinación (Chr() 13) & Chr10)() entre cada línea.

título

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

predeterminado

Opcional. Expresión que se muestra en el cuadro de texto como respuesta predeterminada si no se proporciona ninguna otra entrada de cadena. Si se omite predeterminado, el cuadro de texto aparece 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 posicX , 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 desde la parte superior de la pantalla. Si se omite posicY , el cuadro de diálogo se coloca aproximadamente una tercera hacia abajo en la pantalla.

archivo de ayuda

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

contexto

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


Comentarios

Cuando se proporcionan ArchivoDeAyuda y 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 CuadroEntr devuelve todo 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 utilizar CuadroEntr en una expresión. Para omitir algunos argumentos por posición, debe incluir el correspondiente delimitador de coma.

Ejemplo

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

Este ejemplo muestra varias formas de usar la función CuadroEntr para pedir al usuario que escriba un valor. Si x e y posiciones se omiten, el cuadro de diálogo queda automáticamente centrado para los respectivos ejes. 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)
Ampliar sus conocimientos de Office
Explorar los cursos
Obtener nuevas características primero
Únase a los participantes de Office Insider

¿Le ha sido útil esta información?

¡Gracias por sus comentarios!

Gracias por sus comentarios. Quizá le interese ponerse en contacto con uno de nuestros agentes de soporte de Office.

×