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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

Exibe um aviso em uma caixa de diálogo, aguarda até que o usuário insira um texto ou clique 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 String necessária exibida como a mensagem na caixa de diálogo. O tamanho máximo de Prompt é de aproximadamente 1.024 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 linha de alimentação (Chr(10)) ou uma combinação de retorno de carro/alimentação de linha (Chr(13) & Chr(10)) entre cada linha.

Title

String

Opcional. Expressão String 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

Opcional. Expressão String 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

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

YPos

Int32

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

Retornos

String

Exibe um aviso em uma caixa de diálogo, aguarda até que o usuário insira um texto ou clique 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 conterá 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 .

Confira também

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