Función CuadroEntr

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 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 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 retorno y avance de línea combinación de caracteres carro (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)

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.

Ampliar sus conocimientos
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.

×