Interaction.InputBox(String, String, String, Int32, Int32) Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

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 -> string

Public Function InputBox (Prompt As String, Optional Title As String = "", Optional DefaultResponse As String = "", Optional XPos As Integer = -1, Optional YPos As Integer = -1) As String

Parámetros

Prompt

String

Es un parámetro necesario. Expresión de tipo String que se muestra como mensaje en el cuadro de diálogo. La longitud máxima de Prompt es aproximadamente de 1024 caracteres, dependiendo del ancho de los caracteres utilizados. 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) & Chr(10)) entre cada línea.

Title

String

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

DefaultResponse

String

Opcional. Expresión de tipo String que se muestra en el cuadro de texto como respuesta predeterminada si no se proporciona ninguna entrada. Si se omite DefaultResponse, el cuadro de texto mostrado está vacío.

XPos

Int32

Opcional. Expresión numérica que especifica, en twips, la distancia entre el borde izquierdo del cuadro de diálogo y el borde izquierdo de la pantalla. Si se omite XPos, el cuadro de diálogo estará centrado horizontalmente.

YPos

Int32

Opcional. Expresión numérica que especifica, en twips, la distancia entre el borde superior del cuadro de diálogo y la parte superior de la pantalla. Si se omite YPos, el cuadro de diálogo se coloca verticalmente a aproximadamente un tercio de la parte superior de la pantalla.

Devoluciones

String

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 para 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 que el primer argumento, debe usar la InputBox función en una expresión. Si omite algún 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 .

Consulte también

• MsgBox(Object, MsgBoxStyle, Object)
• Chr(Int32)
• ChrW(Int32)