Função InputBox

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

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

Sintaxe

InputBox ( prompt [título ] [padrão ] [, xpos ] [, ypos ] [, arquivo de ajuda ] [contexto ] )

A sintaxe da função InputBox possui os seguintes argumentos:

Argumento

Descrição

prompt

Necessário. Exibida como a mensagem na caixa de diálogo de expressão de cadeia de caracteres. O comprimento máximo de prompt é aproximadamente 1024 caracteres, dependendo a largura dos caracteres usados. Se prompt consistir em mais de uma linha, você pode separar as linhas usando um caractere de retorno de carro (Chr(13)), um caractere de alimentação de linha (Chr(10)) ou carro retorno – alimentação de linha combinação de caracteres (Chr(13) & Chr(10)) entre cada linha.

título

Opcional. Expressão exibida na barra de título da caixa de diálogo de cadeia de caracteres. Se você omitir o título, o nome do aplicativo é colocado na barra de título.

padrão

Opcional. Expressão em sequência exibida na caixa de texto como a resposta padrão se nenhuma outra entrada é fornecida. Se você omitir padrão, a caixa de texto é exibida vazia.

XPOs

Opcional. Expressão numérica que especifica, em twips, a distância horizontal da borda esquerda da caixa de diálogo a partir da 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 da parte superior da tela. Se ypos for omitido, a caixa de diálogo será verticalmente posicionada aproximadamente um terceiro à maneira como a tela para baixo.

arquivo de ajuda

Opcional. Expressão de cadeia de caracteres que identifica o arquivo de ajuda para usar para fornecer ajuda contextual para a caixa de diálogo. Se o arquivo de ajuda é fornecido, contexto também deve ser fornecido.

contexto

Opcional. Expressão numérica que é o número de contexto de Ajuda atribuído para o tópico de Ajuda apropriado pelo autor da Ajuda. Se o contexto é fornecido, o arquivo de ajuda também deve ser fornecido.


Comentários

Quando o arquivo de ajuda e contexto são fornecidos, o usuário pode pressionar F1 (Windows) ou HELP (Macintosh) para exibir o tópico de ajuda correspondente ao contexto. Alguns aplicativo host, por exemplo, Microsoft Office Excel 2007, também adicionam automaticamente um botão Ajuda à caixa de diálogo. Se o usuário clica Okey ou pressiona ENTER, a função InputBox retorna tudo o que está na caixa de texto. Se o usuário clicar em Cancelar, a função retornará uma cadeia de caracteres de comprimento zero ("").

Observação : Para especificar mais que o primeiro argumento nomeado, você deve usar InputBox em um expressão. Para omitir alguns argumentos posicionais, você deve incluir a vírgula delimitadora correspondente.

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

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

Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×