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

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Exibe um prompt em uma caixa de diálogo, aguarda o usuário inserir texto ou clicar em um botão e retorna uma cadeia de caracteres que contém o conteúdo da caixa 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

Expressão necessária String exibida como a mensagem na caixa de diálogo. O comprimento máximo é de Prompt aproximadamente 1024 caracteres, dependendo da largura dos caracteres usados. Se Prompt consistir em mais de uma linha, você poderá separar as linhas usando um caractere de retorno de carro (Chr(13)), um caractere de feed de linha (Chr(10)) ou uma combinação de retorno de carro/alimentação de linha (Chr(13) & Chr(10)) entre cada linha.

Title
String

Optional. String expressão exibida na barra de título da caixa de diálogo. Se você omitir Title, o nome do aplicativo será colocado na barra de título.

DefaultResponse
String

Optional. String expressão exibida na caixa de texto como a resposta padrão se nenhuma outra entrada for fornecida. Se você omitir DefaultResponse, a caixa de texto exibida estará vazia.

XPos
Int32

Optional. Expressão numérica que especifica, em twips, a distância da borda esquerda da caixa de diálogo da borda esquerda da tela. Se você omitir XPos, a caixa de diálogo será centralizada horizontalmente.

YPos
Int32

Optional. Expressão numérica que especifica, em twips, a distância da borda superior da caixa de diálogo da parte superior da tela. Se você omitir YPos, a caixa de diálogo será posicionada verticalmente aproximadamente um terço do caminho para baixo da tela.

Retornos

String

Exibe um prompt em uma caixa de diálogo, aguarda o usuário inserir texto ou clicar em um botão e retorna uma cadeia de caracteres que contém o conteúdo da caixa de texto.

Exemplos

Este exemplo mostra várias maneiras de usar a InputBox função para solicitar que o usuário insira um valor. Se as posições x e y forem omitidas, a caixa de diálogo será centralizada automaticamente para os respectivos eixos. A variável MyValue contém o valor inserido pelo usuário se o usuário clicar em OK ou pressionar a tecla ENTER.

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

Comentários

Se o usuário clicar em Cancelar, uma cadeia de caracteres de comprimento zero será retornada.

Para especificar mais do que o primeiro argumento, você deve usar a InputBox função em uma expressão. Se você omitir argumentos posicionais, deverá manter o delimitador de vírgula correspondente.

Observação

A InputBox função requer UIPermission no nível, o SafeTopLevelWindows que pode afetar sua execução em situações de confiança parcial. Para obter mais informações, consulte Solicitando permissões e UIPermission .

Aplica-se a

Confira também