Interaction.InputBox(String, String, String, Int32, Int32) 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 mensaje en un cuadro de diálogo, espera a que el usuario escriba texto o haga clic en un botón y, a continuación, devuelve una cadena que contiene el contenido del cuadro de texto.
public static string InputBox(string Prompt, string Title = "", string DefaultResponse = "", int XPos = -1, int YPos = -1);static member InputBox : string * string * string * int * int -> stringPublic Function InputBox (Prompt As String, Optional Title As String = "", Optional DefaultResponse As String = "", Optional XPos As Integer = -1, Optional YPos As Integer = -1) As StringParámetros
- Prompt
- String
Expresión requerida String que se muestra como mensaje en el cuadro de diálogo. La longitud máxima de es de Prompt aproximadamente 1024 caracteres, en función del ancho de los caracteres usados. Si Prompt consta de más de una línea, puede separar las líneas mediante un carácter de retorno de carro (Chr(13)), un carácter de avance de línea (Chr(10)) o una combinación de retorno de carro/avance de línea (Chr(13) y Chr(10)) entre cada línea.
- Title
- String
Optional.
String expresión que se muestra en la barra de título del cuadro de diálogo. Si omite Title, el nombre de la aplicación se coloca en la barra de título.
- DefaultResponse
- String
Optional.
String expresión mostrada en el cuadro de texto como respuesta predeterminada si no se proporciona ninguna otra entrada. Si omite DefaultResponse, el cuadro de texto mostrado está vacío.
- XPos
- Int32
Optional. Expresión numérica que especifica, en twips, la distancia del borde izquierdo del cuadro de diálogo desde el borde izquierdo de la pantalla. Si omite XPos, el cuadro de diálogo se centra horizontalmente.
- YPos
- Int32
Optional. Expresión numérica que especifica, en twips, la distancia 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 de la pantalla.
Devoluciones
Muestra un mensaje en un cuadro de diálogo, espera a que el usuario escriba texto o haga clic en un botón y, a continuación, devuelve una cadena que contiene el contenido del cuadro de texto.
Ejemplos
En este ejemplo se muestran varias maneras de usar la InputBox función para pedir 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.
Dim message, title, defaultValue As String
Dim myValue As Object
' Set prompt.
message = "Enter a value between 1 and 3"
' Set title.
title = "InputBox Demo"
defaultValue = "1" ' Set default value.
' Display message, title, and default value.
myValue = InputBox(message, title, defaultValue)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue
' Display dialog box at position 100, 100.
myValue = InputBox(message, title, defaultValue, 100, 100)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue
Comentarios
Si el usuario hace clic en Cancelar, se devuelve una cadena de longitud cero.
Para especificar más del primer argumento, debe usar la InputBox función en una expresión. Si omite cualquier argumento posicional, debe conservar el delimitador de coma correspondiente.
Nota:
La InputBox función requiere UIPermission en el SafeTopLevelWindows nivel , lo que puede afectar a su ejecución en situaciones de confianza parcial. Para obtener más información, vea Solicitar permisos y UIPermission .