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

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Apresenta um prompt numa caixa de diálogo, espera que o utilizador insira texto ou clique num botão, e depois devolve uma cadeia contendo 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 apresentada como a mensagem na caixa de diálogo. O comprimento máximo de Prompt é aproximadamente 1024 caracteres, dependendo da largura dos caracteres utilizados. Se Prompt consistir em mais do que uma linha, pode separar as linhas usando um carácter de retorno de carro (Chr(13)), um carácter de alimentação de linha (Chr(10)) ou uma combinação de retorno de carroça/avanço de linha (Chr(13) & Chr(10)) entre cada linha.

Title
String

Optional. String expressão mostrada na barra de título da caixa de diálogo. Se omitir Title, o nome da candidatura aparece na barra de título.

DefaultResponse
String

Optional. String a expressão é exibida na caixa de texto como resposta padrão caso não seja fornecida outra entrada. Se omitires DefaultResponse, a caixa de texto mostrada fica vazia.

XPos
Int32

Optional. Expressão numérica que especifica, em dups, a distância da borda esquerda da caixa de diálogo à borda esquerda do ecrã. Se omitires XPos, a caixa de diálogo fica centrada horizontalmente.

YPos
Int32

Optional. Expressão numérica que especifica, em twips, a distância da borda superior da caixa de diálogo em relação ao topo do ecrã. Se omitir YPos, a caixa de diálogo está posicionada verticalmente, aproximadamente a um terço do ecrã.

Devoluções

String

Apresenta um prompt numa caixa de diálogo, espera que o utilizador insira texto ou clique num botão, e depois devolve uma cadeia contendo o conteúdo da caixa de texto.

Exemplos

Este exemplo mostra várias formas de usar a InputBox função para pedir ao utilizador que introduza um valor. Se as posições x e y forem omitidas, a caixa de diálogo será automaticamente centrada nos respetivos eixos. A variável MyValue contém o valor introduzido pelo utilizador se este 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

Observações

Se o utilizador clicar em Cancelar, é devolvida uma cadeia de comprimento zero.

Para especificar mais do que o primeiro argumento, deve usar a InputBox função numa expressão. Se omitir quaisquer argumentos posicionais, deve manter o correspondente delimitador de vírgula.

Note

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

Aplica-se a

Ver também