A função InputBox exibe uma caixa de diálogo para solicitar entrada do usuário e retornar a resposta. Pode incluir um prompt, título, valor padrão, posição e ajuda contextual. Aceita clique em OK ou Cancelar e retorna a entrada ou cadeia vazia.
Cenários de Aprendizagem - Estratégia para implementação de práticas pedagógicas
Função inPutbox
1. Função InputBox
Exibe um aviso em uma caixa de diálogo, aguarda até que o usuário insira texto ou clique em um
botão e retorna uma String com o conteúdo da caixa de texto.
Sintaxe
InputBox(prompt[, title] [, default] [, xpos] [, ypos] [, helpfile, context])
A sintaxe da função InputBox tem os seguintes argumentos nomeados:
Parte Descrição
Prompt Obrigatória. Expressão de seqüência de caracteres exibida como mensagem na
caixa de diálogo. O comprimento máximo de prompt é de aproximadamente
1.024 caracteres, dependendo da largura dos caracteres utilizados. Se prompt
consistir em mais de uma linha, você poderá separar as linhas utilizando um
caractere de retorno de carro (Chr(13)), um caractere de alimentação de linha
(Chr(10)) ou uma combinação de caracteres de retorno de carro e alimentação
de linha (Chr(13) & Chr(10)) entre cada linha.
Title Opcional. Expressão de seqüência de caracteres exibida na barra de título da
caixa de diálogo. Se você omitir title, o nome do aplicativo será inserido na
barra de título.
Default Opcional. Expressão de seqüência de caracteres exibida na caixa de texto como
resposta padrão se nenhuma entrada for fornecida. Se você omitir default, a
caixa de texto será exibida vazia.
Xpos Opcional. Expressão numérica que especifica, em twips, a distância horizontal
da borda esquerda da caixa de diálogo em relação à borda esquerda da tela. Se
xpos for omitido, a caixa de diálogo será centralizada horizontalmente.
Ypos Opcional. Expressão numérica que especifica, em twips, a distância vertical da
borda superior da caixa de diálogo em relação ao alto da tela. Se ypos for
omitido, a caixa de diálogo será posicionada verticalmente na terça parte
inferior da tela.
Helpfile Opcional. Expressão de seqüência de caracteres que identifica o arquivo de
Ajuda a ser utilizado para fornecer ajuda sensível ao contexto relativa à caixa
de diálogo. Se helpfile for fornecido, context também deverá ser fornecido.
Context Opcional. Expressão numérica que é o número de contexto da Ajuda atribuído
ao tópico da Ajuda apropriado por seu autor. Se context for fornecido, helpfile
também deverá ser fornecido.
2. Comentários
Quando helpfile e context são fornecidos, o usuário pode pressionar F1 (Windows) ou AJUDA
(Macintosh) para visualizar o tópico de Ajuda que corresponde ao context. Alguns aplicativos host,
por exemplo, o Microsoft Excel, também adicionam automaticamente um botão Ajuda à caixa de
diálogo. Se o usuário clicar em OK ou pressionar , a função InputBox retornará o que estiver na
caixa de texto. Se o usuário clicar em Cancelar, a função retornará uma seqüência de caracteres de
comprimento zero ("").
Observação Para especificar mais que o primeiro argumento nomeado, você deve utilizar
InputBox em uma expressão. Para omitir alguns argumentos posicionais, você deve incluir o
delimitador de vírgula correspondente.
Exemplo da função InputBox
Este exemplo mostra várias maneiras de utilizar a função InputBox para solicitar ao usuário que
digite um valor. Se as posições x e y forem omitidas, a caixa de diálogo será automaticamente
centralizada em relação aos respectivos eixos. A variável MeuValor contém o valor digitado pelo
usuário se ele clicar em OK ou pressionar a tecla ENTER. Se o usuário clicar em Cancel, será
retornada uma seqüência de comprimento zero.
Dim Message, Title, Default, MyValue
Message = "Digite um valor entre 1 e 3" ' Define o aviso.
Title = "Demonstração da CaixaDeEntrada" ' Define o título.
Default = "1" ' Define o padrão.
' Exibe a mensagem, o título e o valor padrão.
MyValue = InputBox(Message, Title, Padrão)
' Utiliza o arquivo de Ajuda e o contexto. O botão Ajuda é adicionado
' atomaticamente.
MyValue = InputBox(Message, Title, , , , "DEMO.HLP", 10)
' Exibe a caixa de diálogo na posição 100, 100.
MyValue = InputBox(Message, Title, Padrão, 100, 100)